# Intercom

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

## Connect Intercom

:::steps
1. **Open the catalogue.** In the console, go to **Data · Connections** and press **New connection**.
2. **Choose Intercom.** 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 streams you want, and a sync mode for each. See [choose what to sync](https://docs.sanda-os.com.au/connections/choose-streams).
5. **Run the first sync.** sanda tests the connection, then lands each stream as a table in your warehouse.
:::

## Configuration fields

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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Access token** | string, secret | Yes | Access token for making authenticated requests. |
| **Client Id** | string, secret | No | Client Id for your Intercom application. |
| **Client Secret** | string, secret | No | Client Secret for your Intercom application. |
| **Activity logs stream slice step size (in days)** | integer | No | Set lower value in case of failing long running sync of Activity Logs stream. Default `30`. |
| **Lookback window** | integer | No | The number of days to shift the state value backward for record sync. Default `0`. |
| **Start date** | string | Yes | UTC date and time in the format 2017-01-25T00:00:00Z. Any data before this date will not be replicated. |
| **Num Workers** | integer | No | The number of worker threads to use for concurrent stream processing. Increase this to speed up syncs for workspaces with large volumes of conversations. The default should work for most use cases. Default `10`. |
| **API Rate Limit (requests per minute)** | integer | No | The effective API request budget per minute. The default of 9500 is 95% of the standard Intercom rate limit (10,000/min), leaving headroom for occasional bursts. If your workspace has a higher rate limit (e.g. 150,000/min), set this to ~95% of that value (e.g. 142500) to use your full API throughput. A per-10-second window is derived automatically as api_rate_limit / 6. Default `9500`. |

## Related

:::links
- [Sync modes](https://docs.sanda-os.com.au/connections/sync-modes): How sanda reads each stream 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.
:::