Use these steps to reauthorize Assembled's connection to Intercom. You might need to do this after a security incident, when the Intercom admin who connected Assembled leaves, or when syncs fail with an authorization error.
If you're here because of the November 13, 2026 security incident: Intercom syncs stop until you reconnect. For more about the incident, see November 13, 2026 security incident.
Who does this
- An Assembled admin, or someone with a role that can configure third-party integrations.
- An Intercom admin. We recommend using a shared service account rather than a personal one.
Before you start
- Note any custom Intercom settings you've set up in Assembled, such as queue rules and agent state mappings. Reconnecting uses what you enter in the connect form, so you'll want to check these afterward.
Steps
- If Assembled's old authorization still shows as active in Intercom, have your Intercom admin revoke it and confirm it's inactive before you reconnect.
- In Assembled, go to Configure > Third-party integrations and select Available. On the Intercom card, select Connect integration.
- Sign in to Intercom as an admin and authorize Assembled.
-
On the Intercom card in Configure > Third-party integrations, check that the sync rows show a new successful sync.
How to confirm it's working
- On the Intercom card, check for a recent successful sync. The Connected tag on its own doesn't confirm that data is flowing.
- If a sync row is red, hover over it to see the error, and send that error text to Support.
- If you use AI agents or Copilot with Intercom, test a handoff to Intercom to confirm it still works.
When you'll see data
Assembled syncs Intercom conversations every minute and agent states about every 30 seconds. After you reconnect, allow time for the next scheduled sync. Reports can take a little longer to refresh.
Restoring missed data
Reconnecting normally starts a backfill of your Intercom history automatically. While it runs, the card shows Backfill in progress, and when it's done it shows the date it's backfilled until. If you need a different date range, or you still see gaps from while Intercom was disconnected, contact Support and let us know which dates are affected.
Things to watch for
- Note your settings first. Reconnecting uses what you enter in the connect form, so check your queue rules and mappings afterward.
- Replace any other Intercom tokens. If you saved an Intercom token in Assembled for AI agent tools and connectors, create a new token in Intercom, update it in Assembled, then revoke the old one in Intercom.
- Test your AI handoff. If you use AI agents or Copilot with Intercom, confirm handoffs still reach your team.
- Give it an hour, then check. If conversation volume or agent states still look wrong an hour after reconnecting, contact Support.
For more about how the integration works, see Intercom integration.
Need help?
If something doesn't look right, contact our Support team and include any error text you see on the Intercom card. Please don't send tokens or passwords by email or chat.