Skip to main content
Read and change how the AI works in Intercom: the admin it acts as, where handed-off conversations go, whether every conversation is mirrored into OpenCX, whether unsupported attachments are passed on, and which custom status follows the Intercom snoozed state. Connecting Intercom happens in Settings → Integrations; the access token is never returned.

​
Key Concepts

  • Not connected — reads answer 200 with connected: false; updates answer 404
  • Partial updates — omitted fields keep their value; an empty string clears the handoff admin or team
  • Snooze sync — snooze_sub_status_id must be a custom status of your organization, else 400; null turns it off

​
Available Endpoints

Get settings

Read the AI admin, handoff routing, full sync, attachment forwarding, and snooze sync.

Update settings

Change the AI admin, handoff routing, full sync, attachment forwarding, or snooze sync.

List admins

List the Intercom admins, to pick the AI or handoff admin.

List teams

List the Intercom teams, to pick the handoff team.