Freshdesk
Sync data from your warehouse to Freshdesk. Keep your Freshdesk Contacts and Companies enriched with the latest customer data.
Prerequisites
- A Freshdesk account
- A Freshdesk API key (found in your profile settings)
- Your Freshdesk domain (the subdomain in your Freshdesk URL)
Authentication
Freshdesk uses API Key authentication.
- In Freshdesk, click your profile picture in the top right
- Go to Profile Settings
- Copy your API Key from the right sidebar
- Paste it into the API Key field in SignalSmith
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Domain | Text | Yes | Your Freshdesk domain (e.g., mycompany for mycompany.freshdesk.com) |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Object Type | Select | Yes | The Freshdesk object to sync to: Contacts or Companies |
Supported Operations
Sync Modes
| Mode | Supported |
|---|---|
| Upsert | Yes |
| Insert | Yes |
| Update | Yes |
| Mirror | — |
Audience Sync Modes
| Mode | Supported |
|---|---|
| Add | Yes |
| Remove | Yes |
| Mirror | Yes |
| Upsert | Yes |
Features
- Field Mapping: Yes
- Schema Introspection: Yes — SignalSmith reads field definitions from the Freshdesk Contact Fields and Company Fields APIs
Required Mapping Fields
| Object | Required Fields |
|---|---|
| Contacts | |
| Companies | name |
Troubleshooting
Authentication failed: invalid API key
Verify your API key in Freshdesk Profile Settings. Ensure you are using the API key, not your password.
Domain not found
Ensure the domain matches your Freshdesk URL exactly. For https://mycompany.freshdesk.com, enter mycompany.
Duplicate contact
Freshdesk enforces unique email addresses for contacts. Use Upsert mode to update existing contacts instead of creating duplicates.
Rate limiting
Freshdesk enforces per-minute and per-hour API rate limits based on your plan. SignalSmith handles rate limiting with automatic retries.