Connect Intercom
Link Intercom to Synthight by creating an OAuth app in Intercom's Developer Hub and authorizing access.
Last updated: 2 min read
connect intercomintercom integrationintercom oauth setupsync intercom conversations
Connecting Intercom means creating a small OAuth app inside Intercom, then authorizing it from Synthight.
Before you start
You need admin access to your Intercom workspace's Developer Hub.
1. Create an OAuth app in Intercom
- In Intercom, go to Settings.
- Navigate to Integrations.
- Click Developer Hub, then New app and give it a name.
- Open the new app and click Edit.
- In the authentication section, check Use OAuth.
- Paste the callback URL shown on Synthight's setup screen into the redirect URI field.
- Save the app, then go to the Basic Information tab and copy the Client ID and Client Secret.
2. Connect in Synthight
- Sidebar → Workspace → Connections → click the Intercom card.
- Enter the Client ID and Client Secret.
- Choose the Region matching your Intercom workspace's hosting location: United States (default), European Union, or Australia.
- Choose your Initial Sync Range: Start from now, Last week, Last month, or Last 3 months.
- Click Connect Intercom. A window opens to finish authorization — complete it and return to Synthight.
- Pick which Teams to sync from (or All Teams), then finish setup.
Verify it worked
The Intercom card shows Connected once the sync starts, with a live status update — no page refresh needed.
Disconnecting
Reopen the card and choose Disconnect. This stops syncing new conversations; conversations already imported are unaffected.
Troubleshooting
| Symptom | Fix |
|---|---|
| "Client ID is required" / "Client Secret is required" | Both fields must be filled before you can continue — copy them again from Intercom's Basic Information tab |
| Wrong data appears / setup fails | Confirm the Region matches where your Intercom workspace is actually hosted |
Next steps
Frequently asked questions
Do I need admin access in Intercom to connect it?
Yes. Creating an OAuth app requires admin access to your Intercom workspace's Developer Hub — ask a workspace admin to either do the setup or grant you temporary access.
Which Intercom region should I choose when connecting?
Pick the region matching where your Intercom workspace is actually hosted — United States, European Union, or Australia. Choosing the wrong region is the most common cause of a failed sync.
What happens to conversations already imported if I disconnect Intercom?
Nothing — disconnecting only stops new conversations from syncing. Everything already imported stays in Synthight and remains fully searchable.
Can I sync only specific Intercom teams instead of everything?
Yes. During setup you can choose specific Teams to sync from, or select All Teams to import conversations across your whole workspace.
Was this article helpful?