--- title: Intercom incoming webhook setup guide description: This article describes how to use the Intercom data source to create a webhook in your Intercom account and send actionable events to Tealium. url: https://docs.tealium.com/server-side/data-sources/webhooks/setup-guides/intercom/ --- ## Prerequisites * [Intercom account](https://app.intercom.com/admins/sign_in) * EventStream/AudienceStream account ## How it works Intercom offers a [Webhook API](https://developers.intercom.com/building-apps/docs/setting-up-webhooks) that sends outgoing requests to an endpoint that you specify. These requests act like push notifications to EventStream to inform it about things that happened in your Intercom account. When you add the Intercom data source in the Customer Data Hub (CDH), a unique endpoint is generated. This endpoint is used to configure the Intercom webhook. After it is configured, you can create subscriptions based on topics and receive related push notifications to automate use cases, stay informed, and increase productivity. ## Intercom data source The Intercom data source generates a unique URL to use as the HTTP POST URL in your Intercom configuration. The URL is generated in the following format: ``` https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY ``` To add the Intercom data source to your Tealium CDH profile, see [Data Sources](https://docs.tealium.com/about-data-sources/). After adding and connecting the data source, save and publish your profile. ## Intercom setup After you generate your data source endpoint, use the following steps to go to your Intercom account and create the webhook. 1. Log in to your [Intercom account](https://app.intercom.io/a/apps/_/developer-hub). 1. Navigate to your applications. 1. Select the application you want to configure. 1. Go to **Configure > Webhooks**. 1. For your Intercom data source, specify the request endpoint URL generated by Tealium, as described in the previous section. 1. Select the topics that you want to receive notifications about. ## Events and attributes All incoming Intercom event attributes are automatically prefixed with `intercom_`. For example, Intercom will send the `data.item.conversation_message.type` attribute to Tealium and it will be converted to `intercom_data_item_conversation_message_type` (all lowercase). For a full list of webhook events and attributes generated by Intercom, go to [Intercom - Webhook Models](https://developers.intercom.com/building-apps/docs/webhook-model). |**Event Attribute**| **Type**| **Example**| |---| ---| ---| |`intercom_type`| String| "notification_event"| |`intercom_id`| String| "notif_4e3504a3-ba3f-46dc-ab48-8e4d5bdfdf4e"| |`intercom_created_at`| Number| "1571080403"| |`intercom_topic`| String| "conversation.admin.closed"| |`intercom_data_type`| String| "notification_event_data"| |`intercom_data_item_type`| String| One of the following: | |`intercom_data_item_id`| String| "24098479713"| |`intercom_data_item_user_type`| String| "user"| |`intercom_data_item_user_email`| String| "wz1996@gmail.com"| |`intercom_data_item_assignee_type`| String| "admin"| |`intercom_data_item_assignee_email`| String| "weibin.zhong@intercom.io"| |`intercom_data_item_conversation_message_subject`| String| "Hello"| |`intercom_data_item_conversation_message_body`| String| "<p>This is a new conversation</p>"| |`intercom_data_item_conversation_parts_conversation_parts`| List of objects| "[{"type":"conversation_part", "id": "3928295317"},{"type": "conversation_part", "id": "3928295318"}]"| |`intercom_data_item_tags_tags`| List of objects| "{"type": "tag", "id": "2913705", "name": "API"}, {"type": "tag", "id": "2914621", "name": "Feature request"}]"| |`intercom_data_item_id`| String| "530370b477ad7120001d"| |`intercom_data_item_user_id`| String| "25"| |`intercom_data_item_email`| String| "wash@serenity.io"| |`intercom_data_item_phone`| String| "+1123456789"| |`intercom_data_item_name`| String| "Hoban Washburne"| |`intercom_data_item_company_id`| String| "6"| |`intercom_data_item_event_name`| String| "invited-friend"| ## Vendor documentation [Log in to Intercom](https://app.intercom.com/admins/sign_in) to view the following documentation: * [Intercom Developer Hub](https://app.intercom.io/a/apps/_/developer-hub) * [Intercom: Webhooks Overview](https://developers.intercom.com/building-apps/docs/webhooks) * [Intercom: Setting up Webhooks](https://developers.intercom.com/building-apps/docs/setting-up-webhooks) * [Intercom: Setting up Auth - Permissions and Scopes](https://developers.intercom.com/building-apps/docs/setting-up-oauth#section-permissions) * [Intercom: Webhook Models](https://developers.intercom.com/building-apps/docs/webhook-model)