Freshservice
Overview
The Freshservice connector supports both full refresh and incremental syncs. You can choose if this connector will copy only the new or updated data, or all rows in the tables and columns you set up for replication, every time a sync is run.
Output schema
Several output streams are available from this source:
- Tickets (Incremental)
- Problems (Incremental)
- Changes (Incremental)
- Releases (Incremental)
- Requesters
- Agents
- Locations
- Products
- Vendors
- Assets
- PurchaseOrders
- Software
- Satisfaction Survey Responses
- Requested Items
If there are more endpoints you'd like Airbyte to support, please create an issue.
Features
Feature | Supported? |
---|---|
Full Refresh Sync | Yes |
Incremental Sync | Yes |
SSL connection | Yes |
Namespaces | No |
Performance considerations
The Freshservice connector should not run into Freshservice API limitations under normal usage. The API implements rate limiting that varies based on the Freshservice plan:
- Starter: 100 requests/min overall limit
- Growth: 200 requests/min overall limit
- Pro: 400 requests/min overall limit
- Enterprise: 500 requests/min overall limit
There are also sublimits for specific operations (e.g., "View Ticket" which is 50 requests/min for the Starter plan). The connector automatically handles rate limiting with backoff strategies. Please create an issue if you see any rate limit issues that are not automatically retried successfully.
Getting started
Requirements
- Freshservice Account
- Freshservice API Key
- Freshservice domain name (e.g.,
your-domain.freshservice.com
) - Replication Start Date (in ISO 8601 format:
YYYY-MM-DDTHH:MM:SSZ
)
Setup guide
Freshservice API Key
- Log in to your Freshservice account
- Navigate to your profile settings by clicking on your profile picture in the top right corner
- Under the API section, you will find your API key
- If you don't have an API key, you can generate a new one
For more details, please read How to find your API key.
Domain Name
Your Freshservice domain is the subdomain of your Freshservice account URL. For example, if you access Freshservice at https://your-company.freshservice.com
, then your domain name is your-company.freshservice.com
.
Reference
This connector uses the Freshservice REST API v2. All API requests must use HTTPS.
Reference
Config fields reference
Changelog
Expand to review
Version | Date | Pull Request | Subject |
---|---|---|---|
1.4.25 | 2025-05-10 | 59922 | Update dependencies |
1.4.24 | 2025-05-03 | 59405 | Update dependencies |
1.4.23 | 2025-04-26 | 58877 | Update dependencies |
1.4.22 | 2025-04-19 | 58343 | Update dependencies |
1.4.21 | 2025-04-12 | 57781 | Update dependencies |
1.4.20 | 2025-04-05 | 57197 | Update dependencies |
1.4.19 | 2025-03-29 | 56501 | Update dependencies |
1.4.18 | 2025-03-22 | 55953 | Update dependencies |
1.4.17 | 2025-03-08 | 55272 | Update dependencies |
1.4.16 | 2025-03-01 | 54928 | Update dependencies |
1.4.15 | 2025-02-22 | 54438 | Update dependencies |
1.4.14 | 2025-02-15 | 53758 | Update dependencies |
1.4.13 | 2025-02-08 | 53333 | Update dependencies |
1.4.12 | 2025-02-01 | 52816 | Update dependencies |
1.4.11 | 2025-01-25 | 52313 | Update dependencies |
1.4.10 | 2025-01-18 | 51684 | Update dependencies |
1.4.9 | 2025-01-11 | 51075 | Update dependencies |
1.4.8 | 2024-12-28 | 50574 | Update dependencies |
1.4.7 | 2024-12-21 | 50026 | Update dependencies |
1.4.6 | 2024-12-14 | 49519 | Update dependencies |
1.4.5 | 2024-12-12 | 49187 | Update dependencies |
1.4.4 | 2024-12-11 | 48939 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
1.4.3 | 2024-10-29 | 47732 | Update dependencies |
1.4.2 | 2024-10-28 | 47449 | Update dependencies |
1.4.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
1.4.0 | 2024-08-15 | 44148 | Refactor connector to manifest-only format |
1.3.17 | 2024-08-10 | 43545 | Update dependencies |
1.3.16 | 2024-08-03 | 43254 | Update dependencies |
1.3.15 | 2024-07-27 | 42663 | Update dependencies |
1.3.14 | 2024-07-20 | 42382 | Update dependencies |
1.3.13 | 2024-07-13 | 41713 | Update dependencies |
1.3.12 | 2024-07-10 | 41423 | Update dependencies |
1.3.11 | 2024-07-09 | 41311 | Update dependencies |
1.3.10 | 2024-07-06 | 40941 | Update dependencies |
1.3.9 | 2024-06-25 | 40381 | Update dependencies |
1.3.8 | 2024-06-22 | 40177 | Update dependencies |
1.3.7 | 2024-06-06 | 39173 | [autopull] Upgrade base image to v1.2.2 |
1.3.6 | 2024-05-15 | 38195 | Make connector compatible with builder |
1.3.5 | 2024-04-19 | 37162 | Updating to 0.80.0 CDK |
1.3.4 | 2024-04-18 | 37162 | Manage dependencies with Poetry. |
1.3.3 | 2024-04-15 | 37162 | Base image migration: remove Dockerfile and use the python-connector-base image |
1.3.2 | 2024-04-12 | 37162 | schema descriptions |
1.3.1 | 2024-01-29 | 34633 | Add backoff policy for Requested Items stream |
1.3.0 | 2024-01-15 | 29126 | Add Requested Items stream |
1.2.0 | 2023-08-06 | 29126 | Migrated to Low-Code CDK |
1.1.0 | 2023-05-09 | 25929 | Add stream for customer satisfaction survey responses endpoint |
1.0.0 | 2023-05-02 | 25743 | Correct data types in tickets, agents and requesters schemas to match Freshservice API |
0.1.1 | 2021-12-28 | 9143 | Update titles and descriptions |
0.1.0 | 2021-10-29 | 6967 | 🎉 New Source: Freshservice |