Advanced Analytica Advanced Analytica: IBOM
← All connectors
Freshdesk logo

Source connector

Freshdesk

Set up Freshdesk as a source and move its data into your chosen destination.

Version 3.3.14 certified generally available

Freshdesk

Use this page to set up the Freshdesk source connector and find reference information.

Prerequisites

  • A Freshdesk account with an API key. The API key belongs to the agent whose credentials you use. That agent must have access to the resources you want to sync.
  • Your Freshdesk domain in the format yourcompany.freshdesk.com.
  • To sync Ticket Activities, enable Freshdesk’s scheduled ticket activities export under Admin > Account > Scheduled Exports in your account. Freshdesk deprecated this feature with Legacy Reports in October 2023. It remains available only to accounts that enabled it before deprecation. These include Pro/Enterprise and legacy Estate/Forest plans. You can’t enable it now. Each export file covers one day and remains downloadable for 30 days. Therefore, the stream can only backfill about the last 30 days. Each export file follows the account’s local day. The stream requests one file for each UTC date, starting from the start date. It reads each file in full. It only skips records emitted by an earlier sync or preceding the start date’s UTC day. Without the export enabled, the stream syncs successfully but returns no records.

Set up Freshdesk in Airbyte

  1. Log into your Airbyte Cloud account, or go to your Airbyte Open Source dashboard.
  2. Click Sources, then click + New source.
  3. On the Set up the source page, select Freshdesk from the Source type dropdown.
  4. Enter a name for the Freshdesk connector.
  5. For Domain, enter your Freshdesk domain, for example mycompany.freshdesk.com.
  6. For API Key, enter your Freshdesk API key.
  7. For Start Date, you can enter a date in YYYY-MM-DDTHH:mm:ssZ format. Incremental streams replicate only data created or updated on or after this date. If you don’t set a date, the connector syncs all available data.
  8. For Requests per minute, you can enter a custom rate limit. If you leave this empty, the connector uses your plan’s default. See Performance considerations for details.
  9. For Rate Limit Plan, select your Freshdesk subscription plan. This selection sets the per-endpoint rate limits for the Tickets and Contacts APIs. These differ from the general rate limit. If you’re unsure, select Free Plan to apply the most conservative limits.
  10. For Lookback Window, you can set how many days the Satisfaction Ratings stream re-reads from its current state. This helps capture changes to existing ratings after their initial creation. Records updated before the lookback window aren’t synced again. The default is 14 days.
  11. For Number of Concurrent Threads, you can change the number of parallel sync threads. Higher values speed up syncs but consume more of your API rate limit. The default is 5.
  12. Click Set up source.

Supported sync modes

Supported streams

This source provides the following output streams:

Performance

Freshdesk applies API rate limits based on your plan:

PlanGeneral rate limitTickets list limitContacts list limit
Free50/min50/min50/min
Growth200/min20/min20/min
Pro400/min100/min100/min
Enterprise700/min200/min200/min

The connector follows the Retry-After header and retries automatically when rate-limited. To reduce rate limit errors, select the correct Rate Limit Plan in the connector configuration. This lets the connector budget API calls correctly.

If you increase Number of Concurrent Threads, monitor your rate limit usage. Higher concurrency speeds up syncs but increases the chance of reaching per-minute limits. This is especially important on Free and Growth plans.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
3.3.142026-11-1091495Update dependencies
3.3.132026-11-0390355Show the stream-specific error message when Freshdesk returns 401 Unauthorized.
3.3.122026-11-0390556Update dependencies
3.3.112026-10-2789767Show clear error messages when the satisfaction_ratings or surveys streams return 403 because the Freshdesk plan lacks the Surveys feature.
3.3.102026-10-2789902Update dependencies
3.3.92026-10-2089212Update dependencies
3.3.82026-10-1388631Update dependencies
3.3.72026-10-0988407Cast sla_policies ids back to integers: the API currently returns them as strings, which Freshdesk’s docs do not mention
3.3.62026-10-0687870Update dependencies
3.3.52026-09-3086643Fix the ticket_activities stream reading zero records when the Freshdesk export endpoint returns a list of exports, stop dropping records that fall outside the UTC day slice, and fail the sync instead of returning no records when an export has no download URL
3.3.42026-09-2987146Update dependencies
3.3.32026-09-2286635Update dependencies
3.3.22026-09-1586061Update dependencies
3.3.12026-09-0885482Update dependencies
3.3.02026-08-2180306Add the ticket_activities stream (requires the deprecated Freshdesk scheduled ticket activities export to be enabled on the account)
3.2.272026-08-1884563Update dependencies
3.2.262026-08-1183944Update dependencies
3.2.252026-08-0483464Update dependencies
3.2.242026-07-2882890Update dependencies
3.2.232026-07-2182397Update dependencies
3.2.222026-07-1481833Update dependencies
3.2.212026-06-3081070Update dependencies
3.2.202026-06-2380437Update dependencies
3.2.192026-06-1679864Update dependencies
3.2.182026-06-0979322Update dependencies
3.2.172026-06-0276596Update dependencies
3.2.162026-04-24Add subscription_tier spec field with dynamic plan-based rate limiting
3.2.152026-04-2476979Update source-declarative-manifest base image to 7.17.4
3.2.142026-04-2376957Promoted release candidate to GA
3.2.14-rc.52026-04-22Re-enable HTTPAPIBudget, keep c=5 for Full Tier 2 rollout
3.2.14-rc.42026-04-17Revert default_concurrency from 6 to 5 and disable HTTPAPIBudget for tuning experiment
3.2.14-rc.32026-04-14Concurrency tuning iteration 3: increase default_concurrency from 5 to 6
3.2.14-rc.22026-04-1376272Concurrency tuning iteration 2: increase default_concurrency from 4 to 5
3.2.14-rc.12026-04-1076202Add concurrency_level and num_workers for concurrency tuning
3.2.132026-03-3175719Update dependencies
3.2.122026-03-2474647Update dependencies
3.2.112026-03-0374188Update dependencies
3.2.102026-02-1773400Update dependencies
3.2.92026-02-1072557Update dependencies
3.2.82026-01-2071949Update dependencies
3.2.72026-01-1471629Update dependencies
3.2.62025-12-1870595Update dependencies
3.2.52025-11-2570016Update dependencies
3.2.42025-11-1869435Update dependencies
3.2.32025-10-2968786Update dependencies
3.2.22025-10-2268591Add suggestedStreams
3.2.12025-10-2168420Update dependencies
3.2.02025-10-1468089Complete progressive rollout
3.2.0-rc.22025-10-0967109Migrate to CDK v7
3.2.0-rc.12025-03-1254687Migrate to Manifest-only
3.1.32025-02-2654696Update requests-mock dependency versionb
3.1.22025-01-1143887Starting 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
3.1.12024-06-0639231[autopull] Upgrade base image to v1.2.2
3.1.02024-03-1235699Migrate to low-code
3.0.72024-02-1235187Manage dependencies with Poetry.
3.0.62024-01-1034101Base image migration: remove Dockerfile and use the python-connector-base image
3.0.52023-11-3033000Base image migration: remove Dockerfile and use the python-connector-base image
3.0.42023-06-2427680Fix formatting
3.0.32023-06-0226978Skip the stream if subscription level had changed during sync
3.0.22023-02-0621970Enable availability strategy for all streams
3.0.02023-01-3122164Rename nested business_hours table to working_hours
2.0.12023-01-2721888Set AvailabilityStrategy for streams explicitly to None
2.0.02022-12-2020416Fix SlaPolicies stream schema
1.0.02022-11-1619496Fix Contacts stream schema
0.3.82022-11-1119349Do not rely on response.json() when deciding to retry a request
0.3.72022-11-0318397Fix base url for v2 API.
0.3.62022-09-2917410Migrate to per-stream states.
0.3.52022-09-2717249Added nullable to all stream schemas, added transformation into declared schema types
0.3.42022-09-2717243Fixed the issue, when selected stream is not available due to Subscription Plan
0.3.32022-08-0615378Allow backward compatibility for input configuration
0.3.22022-06-2314049Update parsing of start_date
0.3.12022-06-0313332Add new streams
0.3.02022-05-3012334Implement with latest CDK
0.2.112021-12-148682Migrate to the CDK
0.2.102021-12-068524Update connector fields title/description
0.2.92021-11-168017Bugfix an issue that caused the connector to not sync more than 50000 contacts
0.2.82021-10-287486Include “requester” and “stats” fields in “tickets” stream
0.2.72021-10-136442Add start_date parameter to specification from which to start pulling data.
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.