# Freshdesk

> Connect Freshdesk to sanda: what to prepare, the fields the connection form asks for, and how its data lands in your warehouse.

## Connect Freshdesk

:::steps
1. **Open the catalogue.** In the console, go to **Data · Connections** and press **New connection**.
2. **Choose Freshdesk.** It is listed under crm and support; you can also search for it by name.
3. **Fill in the form.** Enter the fields below. Credentials go straight to sanda’s sync engine and are never stored in sanda’s database.
4. **Choose what to sync.** Pick the tables you want, and a sync mode for each. See [choose what to sync](https://docs.sanda-os.com.au/connections/choose-tables).
5. **Run the first sync.** sanda tests the connection, then lands each table you chose in your warehouse.
:::

## Configuration fields

What the connection form asks for. Required fields are marked; the rest are optional.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **API Key** | string, secret | Yes | Freshdesk API Key. |
| **Domain** | string | Yes | Freshdesk domain |
| **Requests per minute** | integer | No | The number of requests per minute that this source allowed to use. There is a rate limit of 50 requests per minute per app per account. |
| **Start Date** | string | No | UTC date and time. Any data created after this date will be replicated. If this parameter is not set, all data will be replicated. |
| **Lookback Window** | integer | No | Number of days for lookback window for the stream Satisfaction Ratings. Default `14`. |
| **Subscription Plan/Tier** | string | No | Your API subscription tier (affects rate limits). One of `growth`, `pro`, `enterprise`. Default `growth`. |
| **Number of Concurrent Threads** | integer | No | Number of concurrent threads for syncing. Higher values can speed up syncs but may increase API rate limit usage. Adjust based on your Freshdesk API plan. Default `5`. |
| **Rate Limit Plan** | one of 5 options | No | Rate Limit Plan for API Budget. |

### Rate Limit Plan

Rate Limit Plan for API Budget.

Choose one of the following. Each asks for its own fields.

**Free Plan**

No further fields.

**Growth Plan**

No further fields.

**Pro Plan**

No further fields.

**Enterprise Plan**

No further fields.

**Custom Plan**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Contacts Rate** | integer | No | Maximum Rate in Limit/minute for contacts list endpoint in Custom Plan. |
| **General Rate** | integer | No | General Maximum Rate in Limit/minute for other endpoints in Custom Plan. |
| **Tickets Rate** | integer | No | Maximum Rate in Limit/minute for tickets list endpoint in Custom Plan. |


## Related

:::links
- [Sync modes](https://docs.sanda-os.com.au/connections/sync-modes): How sanda reads each table on every run.
- [Sync schedules](https://docs.sanda-os.com.au/connections/schedules): How often a connection runs.
- [Allowlist sanda’s address](https://docs.sanda-os.com.au/connections/allowlist): For a system behind a firewall.
- [Troubleshoot connections](https://docs.sanda-os.com.au/connections/troubleshooting): What an error means and how to fix it.
:::