Skip to content
sandadocs
Console Start free trial

Intercom

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

View as Markdown

Connect Intercom

  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.
  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.

Something unclear or out of date? Tell us, and we will fix the page.