`. Send reply bodies as HTML, for example `
Thanks, your refund is processed.
`. ### Admin topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | admin.added_to_workspace | Admin | An Admin being added to workspace | Read admins | | admin.away_mode_updated | Admin | Admin away mode updates | Read admins | | admin.activity_log_event.created | Admin | Run each time a new admin activity log is created | Read admins | | admin.removed_from_workspace | Admin | An Admin being removed from a workspace | Read admins | | admin.logged_in | Admin | An Admin logging into a workspace | Read admins | | admin.logged_out | Admin | An Admin manually logging out of Intercom in the current workspace or when the Admin's session expires after signing in through [SAML SSO](https://www.intercom.com/help/en/articles/3974587-integrate-with-an-identity-provider-and-log-in-with-saml-sso) | Read admins | ### Article topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | article.created | Article | Article creations | Read and list articles | | article.updated | Article | Article updates | Read and list articles | | article.published | Article | Article published | Read and list articles | | article.unpublished | Article | Article unpublished | Read and list articles | | article.deleted | Article | Article deletions | Read and list articles | ### Audience topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | audience.created | Audience | Audience created | Read audiences | | audience.updated | Audience | Audience updated (name, predicates, or role predicates) | Read audiences | | audience.deleted | Audience | Audience deleted | Read audiences | | audience.member_added | Audience Membership | Content added as a member of an audience | Read audiences | | audience.member_removed | Audience Membership | Content removed as a member of an audience | Read audiences | ### Call topics These topics apply to Intercom Phone calls only. | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | call.started | Call | A call has started | Read conversations | | call.ended | Call | A connected call has ended. Not triggered for calls abandoned during routing. | Read conversations | | call.transcription_available | Call | A call transcription is available | Read conversations | | call.recording_available | Call | A call recording is available | Read conversations | ### Content import source topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | content_import_source.created | Content Import Source | Content import source created | Read content | | content_import_source.updated | Content Import Source | Content import source updated (URL, sync behavior, or status) | Read content | | content_import_source.deleted | Content Import Source | Content import source deleted | Read content | ### Company topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | company.created | Company | Company creations | Read users and companies | | company.deleted | Company | Company deletions | Read users and companies | | company.updated | Company | Company being updated | Read users and companies | | company.contact.attached | Company, Contact | Company attached to a Contact | Read users and companies | | company.contact.detached | Company, Contact | Company detached from a Contact | Read users and companies | ### Contact topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | contact.archived | Contact | Contacts archived | Read users and companiesRead and write users | | contact.deleted | Contact | Contacts deleted | Read users and companies | | contact.email.updated | Contact | A Contact email address is updated | Read users and companiesRead and write users | | contact.lead.added_email | Contact | An email address is added to a Contact(Lead) | Read users and companiesRead and write users | | contact.lead.created | Contact | Contact creations(Lead) | Read users and companiesRead and write users | | contact.lead.signed_up | Contact | Contacts converting from Leads to Users | Read users and companiesRead and write users | | contact.lead.tag.created | Contact Tag | Contacts being tagged (Lead) | Read users and companiesRead and write users | | contact.lead.tag.deleted | Contact Tag | Contacts being untagged (Lead) | Read users and companiesRead and write users | | contact.lead.updated | Contact | Contacts being updated(Lead) | Read users and companiesRead and write users | | contact.merged | Contact ([payload details](#contact-merged-payload)) | Contacts being merged(User and Lead) | Read users and companiesRead and write users | | contact.subscribed | Subscription | Contacts subscribing to email | Read users and companiesRead and write users | | contact.unarchived | Contact | Contacts unarchived | Read users and companiesRead and write users | | contact.unsubscribed | Subscription | Contacts unsubscribing from email | Read users and companiesRead and write users | | contact.user.created | Contact | Contact creations(User) | Read users and companiesRead and write users | | contact.user.tag.created | Contact Tag | Contacts being tagged(User) | Read users and companiesRead and write users | | contact.user.tag.deleted | Contact Tag | Contacts being untagged(User) | Read users and companiesRead and write users | | contact.user.updated | Contact | Contact updated (User) | Read users and companies, Read and write users | ### Conversation topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | conversation.admin.assigned | Conversation | Admin conversation assignments | Read conversations | | conversation.admin.closed | Conversation | Admin conversation closed | Read conversations | | conversation.admin.noted | Conversation | Admin conversation notes | Read conversations | | conversation.admin.open.assigned | Conversation | Admin open conversation assignments | Read conversations | | conversation.admin.opened | Conversation | Admin conversation opens | Read conversations | | conversation.admin.replied | Conversation | Admin conversation replies | Read conversations | | conversation.admin.replied.translated | Conversation | Admin conversation reply translated — see warning above | Read conversations | | conversation.admin.single.created | Conversation | Admin initiated 1:1 conversations | Read conversations | | conversation.admin.snoozed | Conversation | Admin conversation snoozes | Read conversations | | conversation.admin.unsnoozed | Conversation | Admin conversation unsnoozes | Read conversations | | conversation.operator.replied | Conversation | Fin/Bot replies to a conversation | Read conversations | | conversation.deleted | Conversation | Conversation deleted | Read conversations | | conversation_part.redacted | Conversation Part | Conversation parts being deleted | Read conversations | | conversation_part.tag.created | Conversation Part | Conversation parts being tagged | Read conversations | | conversation.priority.updated | Conversation | Conversation priority updated | Read conversations | | conversation.rating.added | Conversation | Conversations getting a rating | Read conversations | | conversation.read | Conversation | Contacts reading conversations(User and Lead) | | | conversation.user.created | Conversation | Contact initiated conversations(User and Lead) | Read conversations | | conversation.user.replied | Conversation | Contact conversation replies(Visitor, Lead and User) | Read conversations | | conversation.contact.attached | Conversation, Contact | Contact attached to a conversation | Read conversations | | conversation.contact.detached | Conversation, Contact | Contact detached from a conversation | Read conversations | | conversation.company.updated | Conversation | Company association updated on a conversation | Read conversations | Webhook serialization changes in v2.15 In API version 2.15 and later, conversation webhook payloads are aligned with API responses: - **Statistics date fields** (`first_contact_reply_at`, `first_assignment_at`, `first_admin_reply_at`, `first_close_at`, `last_assignment_at`, `last_assignment_admin_reply_at`, `last_contact_reply_at`, `last_admin_reply_at`, `last_close_at`) now return Unix timestamp integers instead of ISO8601 strings. - **`body` and `subject` fields** now return plain text instead of HTML. In earlier API versions, these fields continue to use the previous format. ### Content stat topics | Topics | Object | Event description | Permissions | | --- | --- | --- | --- | | content_stat.banner | Content Stat | [Banner message](https://www.intercom.com/help/en/articles/4557393-how-to-create-a-banner-message) events:- receipt (Banner displayed)- goal_success- click- collected_email- reaction | Read content data | | content_stat.carousel | Content Stat | [Mobile carousel](https://www.intercom.com/help/en/articles/4164612-design-and-build-a-mobile-carousel) events:- receipt (Carousel displayed)- goal_success- button_tap- completion- dismissal- permission_grant | Read content data | | content_stat.chat | Content Stat | [Chat message](https://www.intercom.com/help/en/articles/3292781-get-started-sending-chat-and-post-messages) events:- receipt (Chat delivered)- goal_success- open- click- collected_email- reply | Read content data | | content_stat.checklist | Content Stat | [Checklist](https://www.intercom.com/help/en/articles/6612245-intercom-checklists-beta) events:- receipt (Checklist shown)- goal_success | Read content data | | content_stat.custom_bot | Content Stat | [Custom Bot](https://www.intercom.com/help/en/articles/2216447-custom-bots-explained) events:- receipt- goal_success- reply- completion | Read content data | | content_stat.email | Content Stat | [Email](https://www.intercom.com/help/en/articles/3292845-get-started-sending-emails) events:- receipt (Email sent)- goal_success- open- click- replyEmail failure events:- hard_bounce- soft_bounce- spam_complaint- unsubscribe | Read content data | | content_stat.news_item | Content Stat | [News Item](https://www.intercom.com/help/en/articles/6362267-getting-started-with-news#h_61de793119) events:- receipt (News Item displayed)- open- click- reaction | Read content data | | content_stat.post | Content Stat | [Post message](https://www.intercom.com/help/en/articles/3292781-get-started-sending-chat-and-post-messages) events:- receipt (Post sent)- goal_success- open- click- Reply- reaction | Read content data | | content_stat.push | Content Stat | [Push message](https://www.intercom.com/help/en/articles/3292847-get-started-with-mobile-push-messages) events:- receipt (Push sent)- goal_success- OpenPush message failure events:- push_failure | Read content data | | content_stat.series | Content Stat | [Series campaign](https://www.intercom.com/help/en/articles/4425207-series-explained) events:- receipt- goal_success- series_completion- series_disengagement- series_exit | Read content data | | content_stat.series.webhook | Content Stat | [Series Webhook](https://www.intercom.com/help/en/articles/5222039-sending-webhooks-with-series) events:- receiptSeries Webhook failure event:- failure | Read content data | | content_stat.sms | Content Stat | [SMS](https://www.intercom.com/help/en/articles/6311186-creating-and-sending-sms) message events:- receipt (SMS sent)- goal_success- keyword_replyFailure stat types include:- sms_failure- unsubscribe | Read content data | | content_stat.survey | Content Stat | [Survey](https://www.intercom.com/help/en/articles/5966645-how-to-create-a-survey) events:- receipt (Survey shown)- goal_success- answer- click- completion- dismissal | Read content data | | content_stat.tooltip_group | Content Stat | [Tooltip](https://www.intercom.com/help/en/articles/6475942-how-to-create-a-tooltip) events:- receipt- goal_success | Read content data | | content_stat.tour | Content Stat | [Product tour](https://www.intercom.com/help/en/articles/2900885-product-tours-explained) events:- receipt (Tour shown)- goal_success- tour_step_failure- completion | Read content data | ### Dynamic content topics These topics are available from API version 2.17. | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | dynamic_content.created | Dynamic Content | Dynamic content creations | Read dynamic content | | dynamic_content.updated | Dynamic Content | Dynamic content updates | Read dynamic content | | dynamic_content.deleted | Dynamic Content | Dynamic content deletions | Read dynamic content | ### Event topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | event.created | Event | Events created | Read events | ### API Activity topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | api.request.completed | API Request | Successful v3 API request completed | Read API activity logs | ### Internal article topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | internal_article.created | Internal Article | Internal article creations | Read content | | internal_article.updated | Internal Article | Internal article updates | Read content | | internal_article.deleted | Internal Article | Internal article deletions | Read content | ### Jobs topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | job.completed | Job | Job completed | Read jobs | ### Messenger topics Developer Hub subscriptions only `messenger.deployment_completed` is sent only to workspaces that have an installed app whose Developer Hub webhook settings subscribe to this topic. Subscribe through the Developer Hub. A subscription created through the Subscriptions API doesn't trigger this topic on its own. | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | messenger.deployment_completed | Messenger Deployment | A new version of the web Messenger was released | Read users and companies | ### Ping | Topic | Object | Event description | | --- | --- | --- | | ping | Ping | Sent when a post to the subscription's ping resource is received or periodically by Intercom. Ping is always subscribed to. | ### Subscription topics | Topics | Object | Event description | Permissions | | --- | --- | --- | --- | | granular.unsubscribe | Subscription | A User unsubscribes from a message subscription type | Read and list users and companiesRead and write users | | granular.subscribe | Subscription | A User subscribes from a message subscription type | Read and list users and companiesRead and write users | ### Ticket topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | ticket.created | Ticket | Ticket created | Read tickets | | ticket.state.updated | Ticket | Ticket state updated | Read tickets | | ticket.note.created | Ticket | Ticket note created | Read tickets | | ticket.admin.assigned | Ticket | Ticket admin assigned | Read tickets | | ticket.team.assigned | Ticket | Ticket team assigned | Read tickets | | ticket.contact.attached | Ticket | Ticket contact attached | Read tickets | | ticket.contact.detached | Ticket | Ticket contact detached | Read tickets | | ticket.attribute.updated | Ticket | Ticket attribute updated | Read tickets | | ticket.admin.replied | Ticket | Ticket admin replied | Read tickets | | ticket.admin.replied.translated | Ticket | Ticket admin reply translated — see warning above | Read tickets | | ticket.contact.replied | Ticket | Ticket contact replied | Read tickets | | ticket.closed | Ticket* | Ticket conversation closed | Read tickets | | ticket.rating.provided | Ticket | Ticket getting a rating | Read tickets | | ticket.resolved | Ticket | Ticket state transitioned to resolved | Read tickets | | ticket.admin.snoozed | Ticket | Ticket admin snoozed | Read tickets | | ticket.admin.unsnoozed | Ticket | Ticket admin unsnoozed | Read tickets | * The `ticket.closed` payload wraps the Ticket inside a `ticket` field on `data.item` — see the note below. ticket.resolved and ticket.closed webhook topics The `ticket.resolved` and `ticket.closed` webhook topics have distinct behaviors: - **ticket.resolved** - Fires when a ticket's state transitions to "resolved". This is a state-based event. - **ticket.closed** - Fires when a ticket conversation is closed. This is separate from state transitions. **Payload shape (API v2.15+):** The two topics deliver the Ticket in different positions inside the notification payload: - `ticket.resolved` — the Ticket is the top-level item: `data.item.ticket_id`, `data.item.ticket_state`, etc. - `ticket.closed` — the Ticket is nested under a `ticket` field on `data.item`: `data.item.ticket.ticket_id`, `data.item.ticket.ticket_state`, etc. Consumers that handle both topics should branch on the topic name (or check for the presence of `data.item.ticket`) before reading ticket fields. **API Versioning:** In API versions prior to the introduction of `ticket.resolved`, the `ticket.closed` webhook fired when tickets transitioned to "resolved" state. For backward compatibility, both webhooks may fire in certain scenarios when using older API versions. When using the latest API version, these webhooks have distinct behaviors as described above. ### Visitor topics | Topics | Object | Event description | Permissions | | --- | --- | --- | --- | | visitor.signed_up | Visitor | Contacts converting from Visitors to Users | Read users and companiesRead and write users | ### Data connector topics | Topic | Object | Event description | Permissions | | --- | --- | --- | --- | | data_connector.execution.completed | Data Connector Execution | Data Connector action execution completed | Read data connectors | ## Webhook notification object A standard Webhook notification object contains the following fields: | Attribute | Type | Description | | --- | --- | --- | | type | string | Value is 'notification_event' | | id | string | The Intercom defined id representing the notification. | | self | string | The Intercom defined URL for the subscription. Optional. | | created_at | timestamp | The timestamp the notification was created. | | topic | string | Corresponds to a topic. | | delivery_attempts | number | The number of times this notification has been attempted. | | first_sent_at | timestamp | The first time the delivery was attempted. | | data | object | A container for the data associated with the notification. | | data.item | object | The data associated with the notification. Most objects include a `type` field; see each topic's notification object for exceptions. | The contents of the `data.item` object depend on the topic. Where it has a `type` field, that field defines the object. In the example below, the type value of `Company` indicates a company object. ```json { "type": "notification_event", "topic": "company.created", "id": "notif_ccd8a4d0-f965-11e3-a367-c779cae3e1b3", "app_id" : "a86dr8yl", "created_at": 1392731331, "delivery_attempts": 1, "first_sent_at": 1392731392, "data": { "item": { "type": "company", "id": "531ee472cce572a6ec000006", "name": "Example Company Inc.", "company_id": "6", "remote_created_at": 1394531169, "created_at": 1394533506, "updated_at": 1396874658, "custom_attributes": { } } } } ``` ## `contact.merged` payload For `contact.merged` events, `data.item` is the standard Contact object representing the surviving target contact, with an additional `merged_from` field identifying the source contact that was absorbed into it. | Attribute | Type | Description | | --- | --- | --- | | merged_from | object | The source contact that was merged into the target. Contains `type` (`"contact"`) and `id`. | ```json { "type": "contact", "id": "5f2a1b3c4d5e6f7a8b9c0d1e", "external_id": "user-42", "email": "alice@example.com", "name": "Alice Example", "role": "user", "...": "all other Contact fields", "merged_from": { "type": "contact", "id": "6a3b2c4d5e6f7a8b9c0d1e2f" } } ``` The `merged_from` field appears only on the `contact.merged` topic. It is not present on other Contact-shaped webhook events or on REST Contact responses. ## Handling Webhook notifications You will receive notifications on your chosen topics when you set up a subscription. How you handle those notifications, i.e. the HTTP status code returned, will determine the subsequent state of that subscription. Timeout You have 5 seconds to respond to a notification. If you don't send a response within that time, the notification is treated as failed and will be retried only once after 1 minute. If you respond with too many error responses, we drop future notifications for a period of 15 minutes. | Response Code | Description | Action | | --- | --- | --- | | 2xx | Success | The webhook was successfully delivered. | | 410 | Gone | When a 410 is received, we assume the resource is no longer available. We will disable the subscription and no more notifications will be sent. | | 429 | Too many requests | When a 429 is received, all notifications from that subscription will be throttled. Depending on the rate of delivery, this delay can be between 1 minute to 2 hours. If 429s continue and any notification is delayed for > 2 hours then we will drop that notification. | | 4xx (excl. 429)5xx | Client or service errors | We will retry after 1 minute for all other errors. If the 2nd retry fails then we mark the notification delivery as failed. | ## Signed notifications Intercom signs webhook notifications via an `X-Hub-Signature` header. We do this so that you can verify that the notification came from Intercom by decoding the signature. We compute the value of this `X-Hub-Signature` header by creating a signature using the body of the JSON request and your App's `client_secret` value, which you can find on the Basic Info page of your App. The signature is the hexadecimal (40-byte) representation of an SHA-1 signature computed using the HMAC algorithm defined in [RFC2104](http://tools.ietf.org/html/rfc2104). The `X-Hub-Signature` header value starts with the string `sha1=` followed by the signature. ```http POST https://example.org/hooks User-Agent: intercom-parrot-service-client/1.0 X-Hub-Signature: sha1=21ff2e149e0fdcac6f947740f6177f6434bda921 Accept: application/json Content-Type: application/json { "type" : "notification_event", "id" : "notif_78c122d0-23ba-11e4-9464-79b01267cc2e", "topic" : "user.created", "app_id" : "a86dr8yl", "data" : { "type" : "notification_event_data", "item" : { "type" : "user", "id" : "530370b477ad7120001d", "user_id" : "25", "name" : "Joe Example", "unsubscribed_from_emails" : false, "custom_attributes" : {} } } } ``` ## Admin notification object The Admin notification object is similar to the [model returned via the API](https://developers.intercom.com/docs/references/2.15/rest-api/api.intercom.io/Admins/admin/). You can see an example object below: ```json { "type": "admin", "id": "1", "name": "John Doe", "email": "john.doe@intercom.io", "job_title": "CEO", "away_mode_enabled": true, "away_mode_reassign": false, "away_status_reason": "🍔 On lunch", "has_inbox_seat": true, "team_ids": [] } ``` ## Contact Tag notification object We only return the Contact Tag notification object for Webhooks. You can see an example object below: ```json { "type": "contact_tag", "created_at": 1392731331, "tag" : { "id": "1287", "name": "independent", "type": "tag" }, "contact" : { "type": "contact", "id": "1287ab1287fefe", ........ } } ``` A Contact Tag notification object is composed from the existing Contact and Tag objects and is sent when Contacts are tagged and untagged via the `contact.user.tag.created`, `contact.lead.tag.created`, `contact.lead.tag.deleted` and `contact.user.tag.deleted` topics. | Attribute | Type | Description | | --- | --- | --- | | type | string | Value is 'contact_tag'. | | created_at | timestamp | The time the contact tag object was created. | | tag | Tag | The tag that was added or removed. | | contact | contact | The contact that was tagged or untagged. | ## Content Stat notification object We only return the Content Stat notification object for Webhooks. You can see an example object below: ```json { "type": "content_stat.series", "created_at": "2022-10-11T15:01:07.000Z", "content_stat": { "id": 1, "content_type": "series", "content_id": 1, "stat_type": "receipt", "ruleset_id": 29, "content_title": "Untitled", "ruleset_version_id": -1, "receipt_id": 1, "tags": { "type": "list", "has_more": false, "data": [], "total_count": 0 }, "series_id": 1, "series_title": null, "node_id": 3 }, "contact": { "type": "contact", "id": "6318db7dfb80c614fe1792b5", ... } } ``` The Content Stat notification object will match our existing Webhook notification object detailed [here](https://developers.intercom.com/intercom-api-reference/reference/webhook-models#webhook-notification-object) and contains the following fields: | Attribute | Type | Description | | --- | --- | --- | | id | string | The unique identifier for the Content Stat set by Intercom | | content_type | string | The type of Content the Stat relates to, e.g. Email, Chat, Post, Push etc | | content_id | string | The unique identifier for the Content given by Intercom, In an A/B test each version has its own identifier. | | stat_type | string | Type of the stat event. While there are some common stat types like "receipt", others are content specific. Content Type email, for example, has stats for unsubscribe, bounce etc. The list of supported stat types is included in the table above. Others may be added over time. | | content_title | string | The title of Content you see in your Intercom Workspace | | ruleset_id | string | The unique identifier of the Outbound Message the Content relates to in your Intercom Workspace | | ruleset_version_id | string | The unique identifier of the Outbound Message version the Content relates to in your Intercom Workspace | | series_id | string | Optional - If the stat relates to a Content object (email, push, etc) which is part of a Series campaign, this will include the ID of that Series campaign | | series_title | string | Optional - If the stat relates to a Content object (email, push, etc) which is part of a Series campaign, this is title of the Series | | node_id | string | Optional - If the stat relates to a Content object (email, push, etc) which is part of a Series campaign, this is the ID of the Node in the Series | | contact | object | Nested Contact object. This is the user or lead to whom the content was sent. | | company | object | Optional nested Company object. If the content stat relates to a company (company predicates were used in the audience targeting), the company information is also included. | ## Content Stat Survey response notification object The `content_stat.survey` notification object contains additional payload fields relating to Survey answers. The individual answer key is included in the answer stat type event. The answers key is included in the completion stat type event showing all answers in the Survey. | Attribute | Type | Description | | --- | --- | --- | | answered_at | string | The time the question was answered. | | question_id | string | The ID of the specific survey question. | | question_text | string | The text of the question | | response | string | The raw response from the user | ## Data Connector Execution notification object The Data Connector Execution notification object is sent via the `data_connector.execution.completed` topic when a Data Connector action finishes executing. This webhook provides operational visibility into connector execution outcomes without exposing sensitive request/response data. You can see an example object below: ```json { "type": "notification_event", "topic": "data_connector.execution.completed", "id": "notif_78c122d0-23ba-11e4-9464-79b01267cc2e", "app_id": "a86dr8yl", "created_at": 1726425600, "delivery_attempts": 1, "first_sent_at": 1726425600, "data": { "type": "notification_event_data", "item": { "type": "data_connector.execution", "id": "987654321", "app_id": "a86dr8yl", "action_id": "123456789", "action_name": "Create Ticket in System X", "success": false, "http_status": 400, "error_type": "request_configuration_error", "execution_time_ms": 312, "completed_at": "2025-09-16T01:10:18.536Z", "source_type": "workflow", "source_id": "456789012", "conversation_id": "41084211973", "user_id": "6318db7dfb80c614fe1792b5", "admin_id": "1" } } } ``` The `data.item` object contains the execution details with the following fields: ### Execution Metadata | Attribute | Type | Description | | --- | --- | --- | | type | string | Value is always 'data_connector.execution' | | id | string | Unique execution ID for deduplication and reference | | app_id | string | Your workspace ID | | action_id | string | The Data Connector action that was executed | | action_name | string | Human-readable name of the action (e.g., "Create Support Ticket") | ### Execution Results | Attribute | Type | Description | | --- | --- | --- | | success | boolean | `true` if the action completed successfully, `false` otherwise | | http_status | integer | HTTP status code from the external API (0 if unknown or not applicable) | | error_type | string or null | Categorized error type when `success` is `false`, `null` on success. See table below. | ### Timing Information | Attribute | Type | Description | | --- | --- | --- | | execution_time_ms | integer or null | Total execution time in milliseconds from invocation to completion | | completed_at | string | ISO-8601 timestamp of when the execution completed | ### Execution Context | Attribute | Type | Description | | --- | --- | --- | | source_type | string | What triggered this action. See source types table below. | | source_id | string or null | ID of the specific trigger (workflow ID, answer ID, etc.) | | conversation_id | string or null | Related conversation ID if applicable | | user_id | string or null | End user who triggered this if applicable | | admin_id | string or null | Admin or teammate who triggered this if applicable | ### Error Types When `success` is `false`, the `error_type` field categorizes what went wrong: | Error Type | Description | | --- | --- | | `request_configuration_error` | Problem with action configuration (bad URL, missing required fields, etc.) | | `faraday_error` | Network-level error (timeout, connection refused, DNS failure) | | `third_party_error` | External API returned an error response (4xx/5xx status) | | `response_mapping_error` | External API response couldn't be parsed/mapped to expected format | | `token_refresh_error` | OAuth token refresh failed for authenticated connectors | | `fin_action_response_formatting_error` | Response format issues specific to Fin AI Agent actions | | `fin_action_identity_verification_error` | Identity verification failed for Fin actions | | `non_fin_standalone_action_identity_verification_error` | Identity verification failed for standalone (non-Fin) actions | | `email_verification_error` | Email verification failed during action execution | ### Source Types The `source_type` field indicates what triggered the Data Connector execution: | Source Type | Description | | --- | --- | | `workflow` | Triggered by a Workflow automation | | `custom_bot` | Triggered by a Custom Bot (includes all bot variants) | | `answer` | Triggered by Fin AI Agent using a Custom Answer | | `inbox` | Triggered manually from the inbox by a teammate | | `other` | Triggered by other sources (saved replies, etc.) | ## Dynamic content notification object The Dynamic content notification object is sent via the `dynamic_content.created` and `dynamic_content.updated` topics. It matches the [model returned via the API](/docs/references/rest-api/api.intercom.io/dynamic-content/getdynamiccontent). You can see an example object below: ```json { "type": "notification_event", "topic": "dynamic_content.created", "id": "notif_a1b2c3d4-5678-90ab-cdef-1234567890ab", "app_id": "a86dr8yl", "created_at": 1734537259, "delivery_attempts": 1, "first_sent_at": 1734537259, "data": { "type": "notification_event_data", "item": { "type": "dynamic_content", "id": "123", "name": "Support phone number", "key": "support-phone-number", "content_type": "inline", "default_locale": "en", "variations": [ { "type": "dynamic_content_variation", "id": "456", "locale": "en", "brand_id": null, "text_content": "+1-555-0100", "json_blocks": null, "intentionally_empty": false, "created_at": 1734537259, "updated_at": 1734537259 } ], "created_at": 1734537259, "updated_at": 1734537259 } } } ``` The `dynamic_content.deleted` topic sends only `type` and `id`: ```json { "type": "dynamic_content", "id": "123" } ``` ## Audience notification object The Audience notification object is sent via the `audience.created` and `audience.updated` topics. It is similar to the [model returned via the API](/docs/references/rest-api/api.intercom.io/audiences/retrieveaudience). You can see an example object below: ```json { "type": "notification_event", "topic": "audience.created", "id": "notif_a1b2c3d4-5678-90ab-cdef-1234567890ab", "app_id": "a86dr8yl", "created_at": 1717200000, "delivery_attempts": 1, "first_sent_at": 1717200000, "data": { "type": "notification_event_data", "item": { "type": "audience", "id": "123", "name": "VIP Customers", "predicates": [ { "attribute": "company.name", "type": "string", "comparison": "contains", "value": "Acme" } ], "role_predicates": [ { "attribute": "role", "type": "role", "comparison": "eq", "value": "user" } ], "created_at": 1717200000, "updated_at": 1717200000 } } } ``` The `data.item` object contains the audience with the following fields: | Attribute | Type | Description | | --- | --- | --- | | type | string | Value is always `audience`. | | id | string | The unique identifier representing the audience. | | name | string | The name of the audience. | | predicates | array | The predicates that define which contacts belong to the audience. | | role_predicates | array | Role-based predicates that further filter membership by contact role. | | created_at | integer | The time the audience was created, as a Unix timestamp. | | updated_at | integer | The time the audience was last updated, as a Unix timestamp. | The `audience.deleted` topic sends a minimal payload: `type`, `id` and `deleted: true`. ```json { "type": "audience", "id": "123", "deleted": true } ``` ## Audience membership notification object The Audience membership notification object is sent via the `audience.member_added` and `audience.member_removed` topics. It describes a piece of content — for example an article — being added to or removed from an audience. The member is the content entity referenced by the `content` object, not a contact. When an audience is deleted, you receive a single `audience.deleted` notification rather than an `audience.member_removed` notification for each member. You can see an example object below: ```json { "type": "notification_event", "topic": "audience.member_added", "id": "notif_b2c3d4e5-6789-01ab-cdef-2345678901bc", "app_id": "a86dr8yl", "created_at": 1717200000, "delivery_attempts": 1, "first_sent_at": 1717200000, "data": { "type": "notification_event_data", "item": { "type": "audience_membership", "audience_id": "123", "content": { "type": "article_content", "id": "456" } } } } ``` The `data.item` object contains the membership with the following fields: | Attribute | Type | Description | | --- | --- | --- | | type | string | Value is always `audience_membership`. | | audience_id | string | The unique identifier of the audience the content was added to or removed from. | | content | object | The content entity that is the member of the audience. Contains `type` and `id`. | | content.type | string | The type name of the content entity, for example `article_content`. | | content.id | string | The unique identifier of the content entity. | ## Content import source notification object The Content import source notification object is sent via the `content_import_source.created` and `content_import_source.updated` topics. It is similar to the [model returned via the API](/docs/references/rest-api/api.intercom.io/ai-content/getcontentimportsource). You can see an example object below: ```json { "type": "notification_event", "topic": "content_import_source.created", "id": "notif_a1b2c3d4-5678-90ab-cdef-1234567890ab", "app_id": "a86dr8yl", "created_at": 1734537259, "delivery_attempts": 1, "first_sent_at": 1734537259, "data": { "type": "notification_event_data", "item": { "type": "content_import_source", "id": 33, "last_synced_at": "2024-12-18T15:34:19.000Z", "status": "active", "url": "https://support.example.com/us/1", "sync_behavior": "automatic", "created_at": "2024-12-18T15:34:19.000Z", "updated_at": "2024-12-18T15:34:19.000Z", "audience_ids": [5678] } } } ``` The `data.item` object contains the content import source with the following fields: | Attribute | Type | Description | | --- | --- | --- | | type | string | Value is always `content_import_source`. | | id | integer | The unique identifier representing the content import source. | | last_synced_at | string | The time the source was last synced, as an ISO 8601 date-time string. | | status | string | The status of the source: `active` or `deactivated`. When a source is deleted, `content_import_source.deleted` is sent instead. | | url | string | The URL of the root of the external source. | | sync_behavior | string | How the source is synced: `api`, `automatic`, or `manual`. | | created_at | string | The time the source was created, as an ISO 8601 date-time string. | | updated_at | string | The time the source was last updated, as an ISO 8601 date-time string. | | audience_ids | array | The unique identifiers of the audiences associated with the source. | The `content_import_source.deleted` topic sends a minimal identification payload — only `type` and `id` — as noted in the deletion-topics callout at the top of this page: ```json { "type": "content_import_source", "id": "33" } ``` ## Internal article notification object The Internal article notification object is sent via the `internal_article.created` and `internal_article.updated` topics. It is similar to the [model returned via the API](/docs/references/rest-api/api.intercom.io/internal-articles/retrieveinternalarticle). Unlike most notification objects, it has no `type` field. You can see an example object below: ```json { "type": "notification_event", "topic": "internal_article.created", "id": "notif_c3d4e5f6-7890-12ab-cdef-3456789012cd", "app_id": "a86dr8yl", "created_at": 1734537259, "delivery_attempts": 1, "first_sent_at": 1734537259, "data": { "type": "notification_event_data", "item": { "id": 6871119, "title": "Refund handling guide", "body": "Check the order status before issuing a refund.
", "body_markdown": "Check the order status before issuing a refund.", "owner_id": 5017691, "author_id": 5017691, "locale": "en", "folder_id": 6, "audience_ids": [1, 2], "ai_chatbot_availability": true, "ai_copilot_availability": true, "ai_sales_agent_availability": false, "created_at": "2024-12-18T15:34:19.000Z", "updated_at": "2024-12-18T15:34:19.000Z", "tags": { "type": "tag.list", "tags": [ { "type": "tag", "id": "1287", "name": "Refunds", "applied_at": 1734537259, "applied_by": { "type": "admin", "id": "5017691" } } ] } } } } ``` The `data.item` object contains the internal article with the following fields: | Attribute | Type | Description | | --- | --- | --- | | id | integer | The unique identifier for the internal article. | | title | string | The title of the internal article. | | body | string | The body of the internal article in HTML. Can be an empty string. | | body_markdown | string or null | The body of the internal article in Markdown, or `null` if the conversion fails. | | owner_id | integer or null | The id of the teammate who owns the internal article, or `null` if it has no owner. | | author_id | integer or null | The id of the author of the internal article, or `null` if there is none. | | locale | string | The default locale of the internal article. | | folder_id | integer or null | The id of the folder the internal article is in, or `null` if it is not in a folder. | | audience_ids | array | The unique identifiers of the audiences the internal article is targeted to. | | ai_chatbot_availability | boolean | Whether the internal article is available for Fin AI Agent. | | ai_copilot_availability | boolean | Whether the internal article is available for AI Copilot. | | ai_sales_agent_availability | boolean | Whether the internal article is available for AI Sales Agent. | | created_at | string | The time the internal article was created, as an ISO 8601 date-time string. | | updated_at | string | The time the internal article was last updated, as an ISO 8601 date-time string. | | tags | object | The tags applied to the internal article, as a `tag.list` object. | | tags.tags.applied_at | integer | The time the tag was applied, as a Unix timestamp. | | tags.tags.applied_by | object | Who applied the tag, with a `type` and an `id`. `type` is `admin`, or `nobody_admin` with a `null` `id` when no teammate applied it. | The `internal_article.deleted` topic sends a minimal identification payload — only `type` and `id` — as noted in the deletion-topics callout at the top of this page: ```json { "type": "internal_article", "id": "6871119" } ``` ## Messenger deployment notification object The Messenger deployment notification object is sent via the `messenger.deployment_completed` topic when a new version of the web Messenger is released. It covers the web Messenger only, not the iOS or Android SDKs, and lists the JavaScript files that make up the release. This topic is sent only to workspaces that have an installed app whose Developer Hub webhook settings subscribe to it. Unlike most notification objects, it has no `type` field. You can see an example object below: ```json { "type": "notification_event", "topic": "messenger.deployment_completed", "id": "notif_d4e5f6a7-8901-23ab-cdef-4567890123de", "app_id": "a86dr8yl", "created_at": 1717200000, "delivery_attempts": 1, "first_sent_at": 1717200000, "data": { "type": "notification_event_data", "item": { "messenger_version": "abcd1234", "released_at": "2026-06-04T09:30:00Z", "assets": [ { "name": "shim.abcd1234.js", "url": "https://js.intercomcdn.com/shim.abcd1234.js", "integrity": "sha384-ABC123XYZ789" }, { "name": "frame.abcd1234.js", "url": "https://js.intercomcdn.com/frame.abcd1234.js", "integrity": "sha384-DEF456UVW012" } ] } } } ``` The `data.item` object contains the deployment with the following fields: | Attribute | Type | Description | | --- | --- | --- | | messenger_version | string | The identifier of the web Messenger version that was released. | | released_at | string | The time the Messenger version was released. | | assets | array | The files in the release. Each has a `name`, `url` and `integrity`. | | assets.name | string | The name of the file, for example `shim.abcd1234.js`. | | assets.url | string | The URL the file is served from. | | assets.integrity | string | The Subresource Integrity hash of the file. |