Sign in
Custom Channel Events

Notify Intercom of a new conversation created in a custom channel

Notifies Intercom that a new conversation was created in your custom channel/platform. This triggers conversation creation and workflow automations within Intercom for your custom channel integration.

Note: This endpoint is currently under managed availability. Please reach out to your accounts team to discuss access and tailored, hands-on support.

post/custom_channel_events/notify_new_conversation

Request body

event_idstring required

Unique identifier for the event.

external_conversation_idstring required

Identifier for the conversation in your application.

Response

Successfully notified Intercom

external_conversation_idstring required

The external conversation ID provided in the notification request

conversation_idstring required

The Intercom conversation ID mapped to the external conversation ID

external_contact_idstring required

The external contact ID provided in the notification request

contact_idstring required

The Intercom contact ID mapped to the external contact ID

Changes