CRM
Intercom
Sync Intercom contacts and conversations into Atlas so customer chats sit next to deals and tasks.
What this connector does
- Sync Intercom contacts and companies into Atlas Growth records.
- Mirror conversation events into the customer timeline.
- Create Atlas tasks from Intercom conversation notes.
- Listen for conversation events with signed webhooks.
Before you begin
- You are an Intercom workspace admin.
- Your plan allows building developer apps.
- You have a test workspace for first validation.
Get your credentials
Open Intercom developer hub
Sign in with the admin account. Intercom developer hub
Create a new app
Click New app, name it Atlas Connector.
Add the Atlas redirect URL
Under Authentication, set Redirect URL to https://YOUR-ATLAS-HOST/oauth/callback/intercom.
Add scopes
Pick Read users and companies, Write users and companies, Read conversations, Read admins.
Copy the client id and secret
Open Basic information and copy Client ID and Client Secret into the Atlas Intercom connector settings page.
Required scopes and permissions
read_users_companieswrite_users_companiesread_conversationsread_adminsSetup checklist
- Create the provider app in a sandbox or development workspace.
- Add the Atlas redirect URL to the provider app configuration.
- Copy the client id, client secret, or API key.
- Paste the credentials into the Atlas connector settings page.
- Click Connect and complete the provider sign-in screen.
- Run Test connection from the connector page to verify health.
Troubleshooting
token_revoked
Refresh token expired or revoked. Reconnect from Atlas.
Missing scope
Add the missing scope under Authentication and reinstall the app on the workspace.
rate_limit_exceeded
Intercom limits to 1000 requests per minute per workspace. Atlas backs off automatically.
Webhooks
Atlas registers Intercom topic subscriptions and validates the X-Hub-Signature header on every event.
Events Atlas listens for
- conversation.user.created
- conversation.user.replied
- conversation.admin.replied
- contact.created
Provider docs: https://developers.intercom.com/building-apps/docs/webhooks
Disconnect and data deletion
- Click Disconnect on the Atlas Intercom connector page.
- Open Settings, Authorized apps in Intercom and revoke Atlas Connector.
- Atlas removes cached Intercom data within 24 hours of disconnect.
Once you have the credentials above, paste them into the live connector page to finish connecting Intercom.
Open the Intercom connector page