# Intercom (/integrations/intercom)





{/* MANUAL-CONTENT-START:intro */}

Use [Intercom](https://www.intercom.com/) in Sim to manage contacts and companies, read and reply to conversations, create, retrieve, and update tickets, and send messages. Connect these operations to support triage, follow-up, and CRM synchronization workflows.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Create, get, update, list, search, and delete contacts; create, get, and list companies; get, list, reply, and search conversations; create, get, and update tickets; and create messages.

## Actions [#actions]

### Create Contact in Intercom [#create-contact-in-intercom]

Create a new contact in Intercom with email, external\_id, or role. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `role` | string | No | The role of the contact. Accepts 'user' or 'lead'. Defaults to 'lead' if not specified. |
  | `email` | string | No | The contact's email address |
  | `external_id` | string | No | A unique identifier for the contact provided by the client |
  | `phone` | string | No | The contact's phone number |
  | `name` | string | No | The contact's name |
  | `avatar` | string | No | An avatar image URL for the contact |
  | `signed_up_at` | number | No | The time the user signed up as a Unix timestamp |
  | `last_seen_at` | number | No | The time the user was last seen as a Unix timestamp |
  | `owner_id` | string | No | The id of an admin that has been assigned account ownership of the contact |
  | `unsubscribed_from_emails` | boolean | No | Whether the contact is unsubscribed from emails |
  | `custom_attributes` | string | No | Custom attributes as JSON object (e.g., \{"attribute\_name": "value"}) |
  | `company_id` | string | No | Company ID to associate the contact with during creation |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `contact` | object | Created contact object |
  | ↳ `id` | string | Unique identifier for the contact |
  | ↳ `type` | string | Object type (contact) |
  | ↳ `role` | string | Role of the contact (user or lead) |
  | ↳ `email` | string | Email address of the contact |
  | ↳ `phone` | string | Phone number of the contact |
  | ↳ `name` | string | Name of the contact |
  | ↳ `avatar` | string | Avatar URL of the contact |
  | ↳ `owner_id` | string | ID of the admin assigned to this contact |
  | ↳ `external_id` | string | External identifier for the contact |
  | ↳ `created_at` | number | Unix timestamp when contact was created |
  | ↳ `updated_at` | number | Unix timestamp when contact was last updated |
  | ↳ `signed_up_at` | number | Unix timestamp when user signed up |
  | ↳ `last_seen_at` | number | Unix timestamp when user was last seen |
  | ↳ `workspace_id` | string | Workspace ID the contact belongs to |
  | ↳ `custom_attributes` | object | Custom attributes set on the contact |
  | ↳ `tags` | object | Tags associated with the contact |
  | ↳ `type` | string | List type |
  | ↳ `url` | string | URL to fetch tags |
  | ↳ `data` | array | Array of tag objects |
  | ↳ `has_more` | boolean | Whether there are more tags |
  | ↳ `total_count` | number | Total number of tags |
  | ↳ `notes` | object | Notes associated with the contact |
  | ↳ `type` | string | List type |
  | ↳ `url` | string | URL to fetch notes |
  | ↳ `data` | array | Array of note objects |
  | ↳ `has_more` | boolean | Whether there are more notes |
  | ↳ `total_count` | number | Total number of notes |
  | ↳ `companies` | object | Companies associated with the contact |
  | ↳ `type` | string | List type |
  | ↳ `url` | string | URL to fetch companies |
  | ↳ `data` | array | Array of company objects |
  | ↳ `has_more` | boolean | Whether there are more companies |
  | ↳ `total_count` | number | Total number of companies |
  | ↳ `location` | object | Location information for the contact |
  | ↳ `type` | string | Location type |
  | ↳ `city` | string | City |
  | ↳ `region` | string | Region/State |
  | ↳ `country` | string | Country |
  | ↳ `country_code` | string | Country code |
  | ↳ `continent_code` | string | Continent code |
  | ↳ `social_profiles` | object | Social profiles of the contact |
  | ↳ `type` | string | List type |
  | ↳ `data` | array | Array of social profile objects |
  | ↳ `unsubscribed_from_emails` | boolean | Whether contact is unsubscribed from emails |
  | `contactId` | string | ID of the created contact |
</ReferenceDetails>

### Get Single Contact from Intercom [#get-single-contact-from-intercom]

Get a single contact by ID from Intercom. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | Contact ID to retrieve |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `contact` | object | Contact object |
  | ↳ `id` | string | Unique identifier for the contact |
  | ↳ `type` | string | Object type (contact) |
  | ↳ `role` | string | Role of the contact (user or lead) |
  | ↳ `email` | string | Email address of the contact |
  | ↳ `email_domain` | string | Email domain of the contact |
  | ↳ `phone` | string | Phone number of the contact |
  | ↳ `name` | string | Name of the contact |
  | ↳ `avatar` | string | Avatar URL of the contact |
  | ↳ `owner_id` | string | ID of the admin assigned account ownership |
  | ↳ `external_id` | string | External identifier provided by the client |
  | ↳ `workspace_id` | string | Workspace ID the contact belongs to |
  | ↳ `created_at` | number | Unix timestamp when contact was created |
  | ↳ `updated_at` | number | Unix timestamp when contact was last updated |
  | ↳ `signed_up_at` | number | Unix timestamp when user signed up |
  | ↳ `last_seen_at` | number | Unix timestamp when user was last seen |
  | ↳ `last_contacted_at` | number | Unix timestamp when contact was last contacted |
  | ↳ `last_replied_at` | number | Unix timestamp when contact last replied |
  | ↳ `last_email_opened_at` | number | Unix timestamp when contact last opened an email |
  | ↳ `last_email_clicked_at` | number | Unix timestamp when contact last clicked an email link |
  | ↳ `has_hard_bounced` | boolean | Whether email to this contact has hard bounced |
  | ↳ `marked_email_as_spam` | boolean | Whether contact marked email as spam |
  | ↳ `unsubscribed_from_emails` | boolean | Whether contact is unsubscribed from emails |
  | ↳ `browser` | string | Browser used by contact |
  | ↳ `browser_version` | string | Browser version |
  | ↳ `browser_language` | string | Browser language setting |
  | ↳ `os` | string | Operating system |
  | ↳ `language_override` | string | Language override setting |
  | ↳ `custom_attributes` | object | Custom attributes set on the contact |
  | ↳ `tags` | object | Tags associated with the contact (up to 10 displayed) |
  | ↳ `type` | string | List type identifier |
  | ↳ `url` | string | URL to fetch full list |
  | ↳ `data` | array | Array of objects (up to 10) |
  | ↳ `has_more` | boolean | Whether there are more items beyond this list |
  | ↳ `total_count` | number | Total number of items |
  | ↳ `notes` | object | Notes associated with the contact (up to 10 displayed) |
  | ↳ `type` | string | List type identifier |
  | ↳ `url` | string | URL to fetch full list |
  | ↳ `data` | array | Array of objects (up to 10) |
  | ↳ `has_more` | boolean | Whether there are more items beyond this list |
  | ↳ `total_count` | number | Total number of items |
  | ↳ `companies` | object | Companies associated with the contact (up to 10 displayed) |
  | ↳ `type` | string | List type identifier |
  | ↳ `url` | string | URL to fetch full list |
  | ↳ `data` | array | Array of objects (up to 10) |
  | ↳ `has_more` | boolean | Whether there are more items beyond this list |
  | ↳ `total_count` | number | Total number of items |
  | ↳ `location` | object | Location information for the contact |
  | ↳ `type` | string | Object type (location) |
  | ↳ `city` | string | City name |
  | ↳ `region` | string | Region or state name |
  | ↳ `country` | string | Country name |
  | ↳ `country_code` | string | ISO country code |
  | ↳ `continent_code` | string | Continent code |
  | ↳ `social_profiles` | object | Social profiles of the contact |
  | ↳ `type` | string | Object type (social\_profile.list) |
  | ↳ `data` | array | Array of social profile objects |
  | ↳ `type` | string | Social network type (e.g., twitter, facebook) |
  | ↳ `name` | string | Social network name |
  | ↳ `url` | string | Profile URL |
  | ↳ `username` | string | Username on the social network |
  | ↳ `id` | string | User ID on the social network |
</ReferenceDetails>

### Update Contact in Intercom [#update-contact-in-intercom]

Update an existing contact in Intercom. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | Contact ID to update |
  | `role` | string | No | The role of the contact. Accepts 'user' or 'lead'. |
  | `external_id` | string | No | A unique identifier for the contact provided by the client |
  | `email` | string | No | The contact's email address |
  | `phone` | string | No | The contact's phone number |
  | `name` | string | No | The contact's name |
  | `avatar` | string | No | An avatar image URL for the contact |
  | `signed_up_at` | number | No | The time the user signed up as a Unix timestamp |
  | `last_seen_at` | number | No | The time the user was last seen as a Unix timestamp |
  | `owner_id` | string | No | The id of an admin that has been assigned account ownership of the contact |
  | `unsubscribed_from_emails` | boolean | No | Whether the contact is unsubscribed from emails |
  | `custom_attributes` | string | No | Custom attributes as JSON object (e.g., \{"attribute\_name": "value"}) |
  | `company_id` | string | No | Company ID to associate the contact with |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `contact` | object | Updated contact object |
  | ↳ `id` | string | Unique identifier for the contact |
  | ↳ `type` | string | Object type (contact) |
  | ↳ `role` | string | Role of the contact (user or lead) |
  | ↳ `email` | string | Email address of the contact |
  | ↳ `phone` | string | Phone number of the contact |
  | ↳ `name` | string | Name of the contact |
  | ↳ `avatar` | string | Avatar URL of the contact |
  | ↳ `owner_id` | string | ID of the admin assigned to this contact |
  | ↳ `external_id` | string | External identifier for the contact |
  | ↳ `created_at` | number | Unix timestamp when contact was created |
  | ↳ `updated_at` | number | Unix timestamp when contact was last updated |
  | ↳ `workspace_id` | string | Workspace ID the contact belongs to |
  | ↳ `custom_attributes` | object | Custom attributes set on the contact |
  | ↳ `tags` | object | Tags associated with the contact |
  | ↳ `notes` | object | Notes associated with the contact |
  | ↳ `companies` | object | Companies associated with the contact |
  | ↳ `location` | object | Location information for the contact |
  | ↳ `social_profiles` | object | Social profiles of the contact |
  | ↳ `unsubscribed_from_emails` | boolean | Whether contact is unsubscribed from emails |
  | `contactId` | string | ID of the updated contact |
</ReferenceDetails>

### List Contacts from Intercom [#list-contacts-from-intercom]

List all contacts from Intercom with pagination support

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `per_page` | number | No | Number of results per page (max: 150) |
  | `starting_after` | string | No | Cursor for pagination - ID to start after |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `contacts` | array | Array of contact objects |
  | ↳ `id` | string | Unique identifier for the contact |
  | ↳ `type` | string | Object type (contact) |
  | ↳ `role` | string | Role of the contact (user or lead) |
  | ↳ `email` | string | Email address of the contact |
  | ↳ `phone` | string | Phone number of the contact |
  | ↳ `name` | string | Name of the contact |
  | ↳ `external_id` | string | External identifier for the contact |
  | ↳ `created_at` | number | Unix timestamp when contact was created |
  | ↳ `updated_at` | number | Unix timestamp when contact was last updated |
  | ↳ `workspace_id` | string | Workspace ID the contact belongs to |
  | ↳ `custom_attributes` | object | Custom attributes set on the contact |
  | ↳ `tags` | object | Tags associated with the contact |
  | ↳ `companies` | object | Companies associated with the contact |
  | `pages` | object | Pagination information |
  | ↳ `type` | string | Pages type identifier |
  | ↳ `page` | number | Current page number |
  | ↳ `per_page` | number | Number of results per page |
  | ↳ `total_pages` | number | Total number of pages |
  | `total_count` | number | Total number of contacts |
</ReferenceDetails>

### Search Contacts in Intercom [#search-contacts-in-intercom]

Search for contacts in Intercom using a query

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `query` | string | Yes | Search query (e.g., \{"field":"email","operator":"=","value":"[user@example.com](mailto:user@example.com)"}) |
  | `per_page` | number | No | Number of results per page (max: 150) |
  | `starting_after` | string | No | Cursor for pagination |
  | `sort_field` | string | No | Field to sort by (e.g., "name", "created\_at", "last\_seen\_at") |
  | `sort_order` | string | No | Sort order: "ascending" or "descending" |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `contacts` | array | Array of matching contact objects |
  | ↳ `id` | string | Unique identifier for the contact |
  | ↳ `type` | string | Object type (contact) |
  | ↳ `role` | string | Role of the contact (user or lead) |
  | ↳ `email` | string | Email address of the contact |
  | ↳ `phone` | string | Phone number of the contact |
  | ↳ `name` | string | Name of the contact |
  | ↳ `avatar` | string | Avatar URL of the contact |
  | ↳ `owner_id` | string | ID of the admin assigned to this contact |
  | ↳ `external_id` | string | External identifier for the contact |
  | ↳ `created_at` | number | Unix timestamp when contact was created |
  | ↳ `updated_at` | number | Unix timestamp when contact was last updated |
  | ↳ `signed_up_at` | number | Unix timestamp when user signed up |
  | ↳ `last_seen_at` | number | Unix timestamp when user was last seen |
  | ↳ `workspace_id` | string | Workspace ID the contact belongs to |
  | ↳ `custom_attributes` | object | Custom attributes set on the contact |
  | ↳ `tags` | object | Tags associated with the contact |
  | ↳ `notes` | object | Notes associated with the contact |
  | ↳ `companies` | object | Companies associated with the contact |
  | ↳ `location` | object | Location information for the contact |
  | ↳ `social_profiles` | object | Social profiles of the contact |
  | ↳ `unsubscribed_from_emails` | boolean | Whether contact is unsubscribed from emails |
  | `pages` | object | Pagination information |
  | ↳ `type` | string | Pages type identifier |
  | ↳ `page` | number | Current page number |
  | ↳ `per_page` | number | Number of results per page |
  | ↳ `total_pages` | number | Total number of pages |
  | `total_count` | number | Total number of matching contacts |
</ReferenceDetails>

### Delete Contact from Intercom [#delete-contact-from-intercom]

Delete a contact from Intercom by ID. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | Contact ID to delete |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | ID of deleted contact |
  | `deleted` | boolean | Whether the contact was deleted |
</ReferenceDetails>

### Create Company in Intercom [#create-company-in-intercom]

Create or update a company in Intercom

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `company_id` | string | Yes | Your unique identifier for the company |
  | `name` | string | No | The name of the company |
  | `website` | string | No | The company website |
  | `plan` | string | No | The company plan name |
  | `size` | number | No | The number of employees in the company |
  | `industry` | string | No | The industry the company operates in |
  | `monthly_spend` | number | No | How much revenue the company generates for your business. Note: This field truncates floats to whole integers (e.g., 155.98 becomes 155) |
  | `custom_attributes` | string | No | Custom attributes as JSON object |
  | `remote_created_at` | number | No | The time the company was created by you as a Unix timestamp |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `company` | object | Created or updated company object |
  | ↳ `id` | string | Unique identifier for the company |
  | ↳ `type` | string | Object type (company) |
  | ↳ `app_id` | string | Intercom app ID |
  | ↳ `company_id` | string | Your unique identifier for the company |
  | ↳ `name` | string | Name of the company |
  | ↳ `website` | string | Company website URL |
  | ↳ `plan` | object | Company plan information |
  | ↳ `size` | number | Number of employees |
  | ↳ `industry` | string | Industry the company operates in |
  | ↳ `monthly_spend` | number | Monthly revenue from this company |
  | ↳ `session_count` | number | Number of sessions |
  | ↳ `user_count` | number | Number of users in the company |
  | ↳ `created_at` | number | Unix timestamp when company was created |
  | ↳ `updated_at` | number | Unix timestamp when company was last updated |
  | ↳ `remote_created_at` | number | Unix timestamp when company was created by you |
  | ↳ `custom_attributes` | object | Custom attributes set on the company |
  | ↳ `tags` | object | Tags associated with the company |
  | ↳ `type` | string | Tag list type |
  | ↳ `tags` | array | Array of tag objects |
  | ↳ `segments` | object | Segments the company belongs to |
  | ↳ `type` | string | Segment list type |
  | ↳ `segments` | array | Array of segment objects |
  | `companyId` | string | ID of the created/updated company |
</ReferenceDetails>

### Get Company from Intercom [#get-company-from-intercom]

Retrieve a single company by ID from Intercom

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `companyId` | string | Yes | Company ID to retrieve |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `company` | object | Company object |
  | ↳ `id` | string | Unique identifier for the company |
  | ↳ `type` | string | Object type (company) |
  | ↳ `app_id` | string | Intercom app ID |
  | ↳ `company_id` | string | Your unique identifier for the company |
  | ↳ `name` | string | Name of the company |
  | ↳ `website` | string | Company website URL |
  | ↳ `plan` | object | Company plan information |
  | ↳ `size` | number | Number of employees |
  | ↳ `industry` | string | Industry the company operates in |
  | ↳ `monthly_spend` | number | Monthly revenue from this company |
  | ↳ `session_count` | number | Number of sessions |
  | ↳ `user_count` | number | Number of users in the company |
  | ↳ `created_at` | number | Unix timestamp when company was created |
  | ↳ `updated_at` | number | Unix timestamp when company was last updated |
  | ↳ `custom_attributes` | object | Custom attributes set on the company |
  | ↳ `tags` | object | Tags associated with the company |
  | ↳ `segments` | object | Segments the company belongs to |
</ReferenceDetails>

### List Companies from Intercom [#list-companies-from-intercom]

List all companies from Intercom with pagination support. Note: This endpoint has a limit of 10,000 companies that can be returned using pagination. For datasets larger than 10,000 companies, use the Scroll API instead.

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `per_page` | number | No | Number of results per page |
  | `page` | number | No | Page number |
  | `starting_after` | string | No | Cursor for pagination (preferred over page-based pagination) |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `companies` | array | Array of company objects |
  | ↳ `id` | string | Unique identifier for the company |
  | ↳ `type` | string | Object type (company) |
  | ↳ `app_id` | string | Intercom app ID |
  | ↳ `company_id` | string | Your unique identifier for the company |
  | ↳ `name` | string | Name of the company |
  | ↳ `website` | string | Company website URL |
  | ↳ `plan` | object | Company plan information |
  | ↳ `monthly_spend` | number | Monthly revenue from this company |
  | ↳ `session_count` | number | Number of sessions |
  | ↳ `user_count` | number | Number of users in the company |
  | ↳ `created_at` | number | Unix timestamp when company was created |
  | ↳ `updated_at` | number | Unix timestamp when company was last updated |
  | ↳ `custom_attributes` | object | Custom attributes set on the company |
  | ↳ `tags` | object | Tags associated with the company |
  | ↳ `segments` | object | Segments the company belongs to |
  | `pages` | object | Pagination information |
  | ↳ `type` | string | Pages type identifier |
  | ↳ `page` | number | Current page number |
  | ↳ `per_page` | number | Number of results per page |
  | ↳ `total_pages` | number | Total number of pages |
  | `total_count` | number | Total number of companies |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### Get Conversation from Intercom [#get-conversation-from-intercom]

Retrieve a single conversation by ID from Intercom

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `conversationId` | string | Yes | Conversation ID to retrieve |
  | `display_as` | string | No | Set to "plaintext" to retrieve messages in plain text |
  | `include_translations` | boolean | No | When true, conversation parts will be translated to the detected language of the conversation |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversation` | object | Conversation object |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `title` | string | Title of the conversation |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | ↳ `waiting_since` | number | Unix timestamp when waiting for reply |
  | ↳ `snoozed_until` | number | Unix timestamp when snooze ends |
  | ↳ `open` | boolean | Whether the conversation is open |
  | ↳ `state` | string | State of the conversation |
  | ↳ `read` | boolean | Whether the conversation has been read |
  | ↳ `priority` | string | Priority of the conversation |
  | ↳ `admin_assignee_id` | number | ID of assigned admin |
  | ↳ `team_assignee_id` | string | ID of assigned team |
  | ↳ `tags` | object | Tags on the conversation |
  | ↳ `source` | object | Source of the conversation |
  | ↳ `contacts` | object | Contacts in the conversation |
  | ↳ `teammates` | object | Teammates in the conversation |
  | ↳ `conversation_parts` | object | Parts of the conversation |
  | ↳ `statistics` | object | Conversation statistics |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### List Conversations from Intercom [#list-conversations-from-intercom]

List all conversations from Intercom with pagination support

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `per_page` | number | No | Number of results per page (max: 150) |
  | `starting_after` | string | No | Cursor for pagination |
  | `sort` | string | No | Field to sort by (e.g., "waiting\_since", "updated\_at", "created\_at") |
  | `order` | string | No | Sort order: "asc" (ascending) or "desc" (descending) |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversations` | array | Array of conversation objects |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `title` | string | Title of the conversation |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | ↳ `waiting_since` | number | Unix timestamp when waiting for reply |
  | ↳ `open` | boolean | Whether the conversation is open |
  | ↳ `state` | string | State of the conversation |
  | ↳ `read` | boolean | Whether the conversation has been read |
  | ↳ `priority` | string | Priority of the conversation |
  | ↳ `admin_assignee_id` | number | ID of assigned admin |
  | ↳ `team_assignee_id` | string | ID of assigned team |
  | ↳ `tags` | object | Tags on the conversation |
  | ↳ `source` | object | Source of the conversation |
  | ↳ `contacts` | object | Contacts in the conversation |
  | `pages` | object | Pagination information |
  | ↳ `type` | string | Pages type identifier |
  | ↳ `page` | number | Current page number |
  | ↳ `per_page` | number | Number of results per page |
  | ↳ `total_pages` | number | Total number of pages |
  | `total_count` | number | Total number of conversations |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### Reply to Conversation in Intercom [#reply-to-conversation-in-intercom]

Reply to a conversation as an admin in Intercom

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `conversationId` | string | Yes | Conversation ID to reply to |
  | `message_type` | string | Yes | Message type: "comment" or "note" |
  | `body` | string | Yes | The text body of the reply |
  | `admin_id` | string | No | The ID of the admin authoring the reply. If not provided, a default admin (Operator/Fin) will be used. |
  | `attachment_urls` | string | No | Comma-separated list of image URLs (max 10) |
  | `created_at` | number | No | Unix timestamp for when the reply was created. If not provided, current time is used. |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversation` | object | Updated conversation object |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `title` | string | Title of the conversation |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | ↳ `waiting_since` | number | Unix timestamp when waiting for reply |
  | ↳ `open` | boolean | Whether the conversation is open |
  | ↳ `state` | string | State of the conversation |
  | ↳ `read` | boolean | Whether the conversation has been read |
  | ↳ `priority` | string | Priority of the conversation |
  | ↳ `admin_assignee_id` | number | ID of assigned admin |
  | ↳ `team_assignee_id` | string | ID of assigned team |
  | ↳ `tags` | object | Tags on the conversation |
  | ↳ `source` | object | Source of the conversation |
  | ↳ `contacts` | object | Contacts in the conversation |
  | ↳ `conversation_parts` | object | Parts of the conversation |
  | `conversationId` | string | ID of the conversation |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### Search Conversations in Intercom [#search-conversations-in-intercom]

Search for conversations in Intercom using a query. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `query` | string | Yes | Search query as JSON object |
  | `per_page` | number | No | Number of results per page (max: 150) |
  | `starting_after` | string | No | Cursor for pagination |
  | `sort_field` | string | No | Field to sort by (e.g., "created\_at", "updated\_at") |
  | `sort_order` | string | No | Sort order: "ascending" or "descending" |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversations` | array | Array of matching conversation objects |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `title` | string | Title of the conversation |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | ↳ `waiting_since` | number | Unix timestamp when waiting for reply |
  | ↳ `open` | boolean | Whether the conversation is open |
  | ↳ `state` | string | State of the conversation |
  | ↳ `read` | boolean | Whether the conversation has been read |
  | ↳ `priority` | string | Priority of the conversation |
  | ↳ `admin_assignee_id` | number | ID of assigned admin |
  | ↳ `team_assignee_id` | string | ID of assigned team |
  | ↳ `tags` | object | Tags on the conversation |
  | ↳ `source` | object | Source of the conversation |
  | ↳ `contacts` | object | Contacts in the conversation |
  | `pages` | object | Pagination information |
  | ↳ `type` | string | Pages type identifier |
  | ↳ `page` | number | Current page number |
  | ↳ `per_page` | number | Number of results per page |
  | ↳ `total_pages` | number | Total number of pages |
  | `total_count` | number | Total number of matching conversations |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### Create Ticket in Intercom [#create-ticket-in-intercom]

Create a new ticket in Intercom. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `ticket_type_id` | string | Yes | The ID of the ticket type |
  | `contacts` | string | Yes | JSON array of contact identifiers (e.g., \[\{"id": "contact\_id"}]) |
  | `ticket_attributes` | string | Yes | JSON object with ticket attributes including *default\_title* and *default\_description* |
  | `company_id` | string | No | Company ID to associate the ticket with |
  | `created_at` | number | No | Unix timestamp for when the ticket was created. If not provided, current time is used. |
  | `conversation_to_link_id` | string | No | ID of an existing conversation to link to this ticket |
  | `disable_notifications` | boolean | No | When true, suppresses notifications when the ticket is created |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `ticket` | object | Created ticket object |
  | ↳ `id` | string | Unique identifier for the ticket |
  | ↳ `type` | string | Object type (ticket) |
  | ↳ `ticket_id` | string | Ticket ID |
  | ↳ `ticket_type` | object | Type of the ticket |
  | ↳ `ticket_attributes` | object | Attributes of the ticket |
  | ↳ `ticket_state` | string | State of the ticket |
  | ↳ `ticket_state_internal_label` | string | Internal label for ticket state |
  | ↳ `ticket_state_external_label` | string | External label for ticket state |
  | ↳ `created_at` | number | Unix timestamp when ticket was created |
  | ↳ `updated_at` | number | Unix timestamp when ticket was last updated |
  | ↳ `contacts` | object | Contacts associated with the ticket |
  | ↳ `admin_assignee_id` | string | ID of assigned admin |
  | ↳ `team_assignee_id` | string | ID of assigned team |
  | ↳ `is_shared` | boolean | Whether the ticket is shared |
  | ↳ `open` | boolean | Whether the ticket is open |
  | `ticketId` | string | ID of the created ticket |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### Get Ticket from Intercom [#get-ticket-from-intercom]

Retrieve a single ticket by ID from Intercom. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `ticketId` | string | Yes | Ticket ID to retrieve |

  #### Output [#output-14]

  | Parameter | Type | Description |
  | - | - | - |
  | `ticket` | object | Ticket object |
  | ↳ `id` | string | Unique identifier for the ticket |
  | ↳ `type` | string | Object type (ticket) |
  | ↳ `ticket_id` | string | Ticket ID |
  | ↳ `ticket_type` | object | Type of the ticket |
  | ↳ `ticket_attributes` | object | Attributes of the ticket |
  | ↳ `ticket_state` | string | State of the ticket |
  | ↳ `ticket_state_internal_label` | string | Internal label for ticket state |
  | ↳ `ticket_state_external_label` | string | External label for ticket state |
  | ↳ `created_at` | number | Unix timestamp when ticket was created |
  | ↳ `updated_at` | number | Unix timestamp when ticket was last updated |
  | ↳ `contacts` | object | Contacts associated with the ticket |
  | ↳ `admin_assignee_id` | string | ID of assigned admin |
  | ↳ `team_assignee_id` | string | ID of assigned team |
  | ↳ `is_shared` | boolean | Whether the ticket is shared |
  | ↳ `open` | boolean | Whether the ticket is open |
  | `ticketId` | string | ID of the retrieved ticket |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### Update Ticket in Intercom [#update-ticket-in-intercom]

Update a ticket in Intercom (change state, assignment, attributes)

<ReferenceDetails>
  #### Input [#input-15]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `ticketId` | string | Yes | The ID of the ticket to update |
  | `ticket_attributes` | string | No | JSON object with ticket attributes (e.g., \{"*default\_title*":"New Title","*default\_description*":"Updated description"}) |
  | `open` | boolean | No | Set to false to close the ticket, true to keep it open |
  | `is_shared` | boolean | No | Whether the ticket is visible to users |
  | `snoozed_until` | number | No | Unix timestamp for when the ticket should reopen |
  | `admin_id` | string | No | The ID of the admin performing the update (needed for workflows and attribution) |
  | `assignee_id` | string | No | The ID of the admin or team to assign the ticket to. Set to "0" to unassign. |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `ticket` | object | The updated ticket object |
  | ↳ `id` | string | Unique identifier for the ticket |
  | ↳ `type` | string | Object type (ticket) |
  | ↳ `ticket_id` | string | Ticket ID shown in Intercom UI |
  | ↳ `ticket_state` | string | State of the ticket |
  | ↳ `ticket_attributes` | object | Attributes of the ticket |
  | ↳ `open` | boolean | Whether the ticket is open |
  | ↳ `is_shared` | boolean | Whether the ticket is visible to users |
  | ↳ `snoozed_until` | number | Unix timestamp when ticket will reopen |
  | ↳ `admin_assignee_id` | string | ID of assigned admin |
  | ↳ `team_assignee_id` | string | ID of assigned team |
  | ↳ `created_at` | number | Unix timestamp when ticket was created |
  | ↳ `updated_at` | number | Unix timestamp when ticket was last updated |
  | `ticketId` | string | ID of the updated ticket |
  | `ticket_state` | string | Current state of the ticket |
</ReferenceDetails>

### Create Message in Intercom [#create-message-in-intercom]

Create and send a new admin-initiated message in Intercom. Returns API-aligned fields only.

<ReferenceDetails>
  #### Input [#input-16]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `message_type` | string | Yes | Message type: "inapp" for in-app messages or "email" for email messages |
  | `template` | string | Yes | Message template style: "plain" for plain text or "personal" for personalized style |
  | `subject` | string | No | The subject of the message (for email type) |
  | `body` | string | Yes | The body of the message |
  | `from_type` | string | Yes | Sender type: "admin" |
  | `from_id` | string | Yes | The ID of the admin sending the message |
  | `to_type` | string | Yes | Recipient type: "contact" |
  | `to_id` | string | Yes | The ID of the contact receiving the message |
  | `created_at` | number | No | Unix timestamp for when the message was created. If not provided, current time is used. |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | object | Created message object |
  | ↳ `id` | string | Unique identifier for the message |
  | ↳ `type` | string | Object type (message) |
  | ↳ `created_at` | number | Unix timestamp when message was created |
  | ↳ `body` | string | Body of the message |
  | ↳ `message_type` | string | Type of the message (in\_app or email) |
  | ↳ `conversation_id` | string | ID of the conversation created |
  | ↳ `owner` | object | Owner of the message |
  | `messageId` | string | ID of the created message |
  | `success` | boolean | Operation success status |
</ReferenceDetails>

### List Admins from Intercom [#list-admins-from-intercom]

Fetch a list of all admins for the workspace

<ReferenceDetails>
  #### Input [#input-17]

  | Parameter | Type | Required | Description |
  | - | - | - | - |

  #### Output [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `admins` | array | Array of admin objects |
  | ↳ `id` | string | Unique identifier for the admin |
  | ↳ `type` | string | Object type (admin) |
  | ↳ `name` | string | Name of the admin |
  | ↳ `email` | string | Email of the admin |
  | ↳ `job_title` | string | Job title of the admin |
  | ↳ `away_mode_enabled` | boolean | Whether admin is in away mode |
  | ↳ `away_mode_reassign` | boolean | Whether to reassign conversations when away |
  | ↳ `has_inbox_seat` | boolean | Whether admin has a paid inbox seat |
  | ↳ `team_ids` | array | List of team IDs the admin belongs to |
  | ↳ `avatar` | object | Avatar information |
  | ↳ `email_verified` | boolean | Whether email is verified |
  | `type` | string | Object type (admin.list) |
</ReferenceDetails>

### Close Conversation in Intercom [#close-conversation-in-intercom]

Close a conversation in Intercom

<ReferenceDetails>
  #### Input [#input-18]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `conversationId` | string | Yes | The ID of the conversation to close |
  | `admin_id` | string | Yes | The ID of the admin performing the action |
  | `body` | string | No | Optional closing message to add to the conversation |

  #### Output [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversation` | object | The closed conversation object |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `state` | string | State of the conversation (closed) |
  | ↳ `open` | boolean | Whether the conversation is open (false) |
  | ↳ `read` | boolean | Whether the conversation has been read |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | `conversationId` | string | ID of the closed conversation |
  | `state` | string | State of the conversation (closed) |
</ReferenceDetails>

### Open Conversation in Intercom [#open-conversation-in-intercom]

Open a closed or snoozed conversation in Intercom

<ReferenceDetails>
  #### Input [#input-19]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `conversationId` | string | Yes | The ID of the conversation to open |
  | `admin_id` | string | Yes | The ID of the admin performing the action |

  #### Output [#output-19]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversation` | object | The opened conversation object |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `state` | string | State of the conversation (open) |
  | ↳ `open` | boolean | Whether the conversation is open (true) |
  | ↳ `read` | boolean | Whether the conversation has been read |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | `conversationId` | string | ID of the opened conversation |
  | `state` | string | State of the conversation (open) |
</ReferenceDetails>

### Snooze Conversation in Intercom [#snooze-conversation-in-intercom]

Snooze a conversation to reopen at a future time

<ReferenceDetails>
  #### Input [#input-20]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `conversationId` | string | Yes | The ID of the conversation to snooze |
  | `admin_id` | string | Yes | The ID of the admin performing the action |
  | `snoozed_until` | number | Yes | Unix timestamp for when the conversation should reopen |

  #### Output [#output-20]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversation` | object | The snoozed conversation object |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `state` | string | State of the conversation (snoozed) |
  | ↳ `open` | boolean | Whether the conversation is open |
  | ↳ `snoozed_until` | number | Unix timestamp when conversation will reopen |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | `conversationId` | string | ID of the snoozed conversation |
  | `state` | string | State of the conversation (snoozed) |
  | `snoozed_until` | number | Unix timestamp when conversation will reopen |
</ReferenceDetails>

### Assign Conversation in Intercom [#assign-conversation-in-intercom]

Assign a conversation to an admin or team in Intercom

<ReferenceDetails>
  #### Input [#input-21]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `conversationId` | string | Yes | The ID of the conversation to assign |
  | `admin_id` | string | Yes | The ID of the admin performing the assignment |
  | `assignee_id` | string | Yes | The ID of the admin or team to assign the conversation to. Set to "0" to unassign. |
  | `body` | string | No | Optional message to add when assigning (e.g., "Passing to the support team") |

  #### Output [#output-21]

  | Parameter | Type | Description |
  | - | - | - |
  | `conversation` | object | The assigned conversation object |
  | ↳ `id` | string | Unique identifier for the conversation |
  | ↳ `type` | string | Object type (conversation) |
  | ↳ `state` | string | State of the conversation |
  | ↳ `open` | boolean | Whether the conversation is open |
  | ↳ `admin_assignee_id` | number | ID of the assigned admin |
  | ↳ `team_assignee_id` | string | ID of the assigned team |
  | ↳ `created_at` | number | Unix timestamp when conversation was created |
  | ↳ `updated_at` | number | Unix timestamp when conversation was last updated |
  | `conversationId` | string | ID of the assigned conversation |
  | `admin_assignee_id` | number | ID of the assigned admin |
  | `team_assignee_id` | string | ID of the assigned team |
</ReferenceDetails>

### List Tags from Intercom [#list-tags-from-intercom]

Fetch a list of all tags in the workspace

<ReferenceDetails>
  #### Input [#input-22]

  | Parameter | Type | Required | Description |
  | - | - | - | - |

  #### Output [#output-22]

  | Parameter | Type | Description |
  | - | - | - |
  | `tags` | array | Array of tag objects |
  | ↳ `id` | string | Unique identifier for the tag |
  | ↳ `type` | string | Object type (tag) |
  | ↳ `name` | string | Name of the tag |
  | `type` | string | Object type (list) |
</ReferenceDetails>

### Create Tag in Intercom [#create-tag-in-intercom]

Create a new tag or update an existing tag name

<ReferenceDetails>
  #### Input [#input-23]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `name` | string | Yes | The name of the tag. Will create a new tag if not found, or update the name if id is provided. |
  | `id` | string | No | The ID of an existing tag to update. Omit to create a new tag. |

  #### Output [#output-23]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Unique identifier for the tag |
  | `name` | string | Name of the tag |
  | `type` | string | Object type (tag) |
</ReferenceDetails>

### Tag Contact in Intercom [#tag-contact-in-intercom]

Add a tag to a specific contact

<ReferenceDetails>
  #### Input [#input-24]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | The ID of the contact to tag |
  | `tagId` | string | Yes | The ID of the tag to apply |

  #### Output [#output-24]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Unique identifier for the tag |
  | `name` | string | Name of the tag |
  | `type` | string | Object type (tag) |
</ReferenceDetails>

### Untag Contact in Intercom [#untag-contact-in-intercom]

Remove a tag from a specific contact

<ReferenceDetails>
  #### Input [#input-25]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | The ID of the contact to untag |
  | `tagId` | string | Yes | The ID of the tag to remove |

  #### Output [#output-25]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Unique identifier for the tag that was removed |
  | `name` | string | Name of the tag that was removed |
  | `type` | string | Object type (tag) |
</ReferenceDetails>

### Tag Conversation in Intercom [#tag-conversation-in-intercom]

Add a tag to a specific conversation

<ReferenceDetails>
  #### Input [#input-26]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `conversationId` | string | Yes | The ID of the conversation to tag |
  | `tagId` | string | Yes | The ID of the tag to apply |
  | `admin_id` | string | Yes | The ID of the admin applying the tag |

  #### Output [#output-26]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Unique identifier for the tag |
  | `name` | string | Name of the tag |
  | `type` | string | Object type (tag) |
</ReferenceDetails>

### Create Note in Intercom [#create-note-in-intercom]

Add a note to a specific contact

<ReferenceDetails>
  #### Input [#input-27]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | The ID of the contact to add the note to |
  | `body` | string | Yes | The text content of the note |
  | `admin_id` | string | No | The ID of the admin creating the note |

  #### Output [#output-27]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Unique identifier for the note |
  | `body` | string | The text content of the note |
  | `created_at` | number | Unix timestamp when the note was created |
  | `type` | string | Object type (note) |
  | `author` | object | The admin who created the note |
  | ↳ `type` | string | Author type (admin) |
  | ↳ `id` | string | Author ID |
  | ↳ `name` | string | Author name |
  | ↳ `email` | string | Author email |
  | `contact` | object | The contact the note was created for |
  | ↳ `type` | string | Contact type |
  | ↳ `id` | string | Contact ID |
</ReferenceDetails>

### Create Event in Intercom [#create-event-in-intercom]

Track a custom event for a contact in Intercom

<ReferenceDetails>
  #### Input [#input-28]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `event_name` | string | Yes | The name of the event (e.g., "order-completed"). Use past-tense verb-noun format for readability. |
  | `created_at` | number | No | Unix timestamp for when the event occurred. Strongly recommended for uniqueness. |
  | `user_id` | string | No | Your identifier for the user (external\_id) |
  | `email` | string | No | Email address of the user. Use only if your app uses email to uniquely identify users. |
  | `id` | string | No | The Intercom contact ID |
  | `metadata` | string | No | JSON object with up to 10 metadata key-value pairs about the event (e.g., \{"order\_value": 99.99}) |

  #### Output [#output-28]

  | Parameter | Type | Description |
  | - | - | - |
  | `accepted` | boolean | Whether the event was accepted (202 Accepted) |
</ReferenceDetails>

### Attach Contact to Company in Intercom [#attach-contact-to-company-in-intercom]

Attach a contact to a company in Intercom

<ReferenceDetails>
  #### Input [#input-29]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | The ID of the contact to attach to the company |
  | `companyId` | string | Yes | The ID of the company to attach the contact to |

  #### Output [#output-29]

  | Parameter | Type | Description |
  | - | - | - |
  | `company` | object | The company object the contact was attached to |
  | ↳ `id` | string | Unique identifier for the company |
  | ↳ `type` | string | Object type (company) |
  | ↳ `company_id` | string | The company\_id you defined |
  | ↳ `name` | string | Name of the company |
  | ↳ `created_at` | number | Unix timestamp when company was created |
  | ↳ `updated_at` | number | Unix timestamp when company was updated |
  | ↳ `user_count` | number | Number of users in the company |
  | ↳ `session_count` | number | Number of sessions |
  | ↳ `monthly_spend` | number | Monthly spend amount |
  | ↳ `plan` | object | Company plan details |
  | `companyId` | string | ID of the company |
  | `name` | string | Name of the company |
</ReferenceDetails>

### Detach Contact from Company in Intercom [#detach-contact-from-company-in-intercom]

Remove a contact from a company in Intercom

<ReferenceDetails>
  #### Input [#input-30]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `contactId` | string | Yes | The ID of the contact to detach from the company |
  | `companyId` | string | Yes | The ID of the company to detach the contact from |

  #### Output [#output-30]

  | Parameter | Type | Description |
  | - | - | - |
  | `company` | object | The company object the contact was detached from |
  | ↳ `id` | string | Unique identifier for the company |
  | ↳ `type` | string | Object type (company) |
  | ↳ `company_id` | string | The company\_id you defined |
  | ↳ `name` | string | Name of the company |
  | `companyId` | string | ID of the company |
  | `name` | string | Name of the company |
</ReferenceDetails>

## Triggers [#triggers]

A trigger starts a workflow when a supported event occurs in this service.

### Intercom Contact Created [#intercom-contact-created]

Trigger workflow when a new lead is created in Intercom

#### Configuration [#configuration]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |

#### Output [#output-31]

| Parameter | Type | Description |
| - | - | - |
| `topic` | string | The webhook topic (e.g., conversation.user.created) |
| `id` | string | Unique notification ID |
| `app_id` | string | Your Intercom app ID |
| `created_at` | number | Unix timestamp when the event occurred |
| `delivery_attempts` | number | Number of delivery attempts for this notification |
| `first_sent_at` | number | Unix timestamp of first delivery attempt |
| `data` | json | Event data containing the contact object. Access via data.item for contact details including id, role, email, name, phone, external\_id, custom\_attributes, location, avatar, tags, companies, and timestamps |

***

### Intercom Conversation Closed [#intercom-conversation-closed]

Trigger workflow when a conversation is closed in Intercom

#### Configuration [#configuration-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |

#### Output [#output-32]

| Parameter | Type | Description |
| - | - | - |
| `topic` | string | The webhook topic (e.g., conversation.user.created) |
| `id` | string | Unique notification ID |
| `app_id` | string | Your Intercom app ID |
| `created_at` | number | Unix timestamp when the event occurred |
| `delivery_attempts` | number | Number of delivery attempts for this notification |
| `first_sent_at` | number | Unix timestamp of first delivery attempt |
| `data` | json | Event data containing the conversation object. Access via data.item for conversation details including id, state, open, assignee, contacts, conversation\_parts, tags, and source |

***

### Intercom Conversation Created [#intercom-conversation-created]

Trigger workflow when a new conversation is created in Intercom

#### Configuration [#configuration-2]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |

#### Output [#output-33]

| Parameter | Type | Description |
| - | - | - |
| `topic` | string | The webhook topic (e.g., conversation.user.created) |
| `id` | string | Unique notification ID |
| `app_id` | string | Your Intercom app ID |
| `created_at` | number | Unix timestamp when the event occurred |
| `delivery_attempts` | number | Number of delivery attempts for this notification |
| `first_sent_at` | number | Unix timestamp of first delivery attempt |
| `data` | json | Event data containing the conversation object. Access via data.item for conversation details including id, state, open, assignee, contacts, conversation\_parts, tags, and source |

***

### Intercom Conversation Reply [#intercom-conversation-reply]

Trigger workflow when someone replies to an Intercom conversation

#### Configuration [#configuration-3]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |

#### Output [#output-34]

| Parameter | Type | Description |
| - | - | - |
| `topic` | string | The webhook topic (e.g., conversation.user.created) |
| `id` | string | Unique notification ID |
| `app_id` | string | Your Intercom app ID |
| `created_at` | number | Unix timestamp when the event occurred |
| `delivery_attempts` | number | Number of delivery attempts for this notification |
| `first_sent_at` | number | Unix timestamp of first delivery attempt |
| `data` | json | Event data containing the conversation object. Access via data.item for conversation details including id, state, open, assignee, contacts, conversation\_parts, tags, and source |

***

### Intercom User Created [#intercom-user-created]

Trigger workflow when a new user is created in Intercom

#### Configuration [#configuration-4]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |

#### Output [#output-35]

| Parameter | Type | Description |
| - | - | - |
| `topic` | string | The webhook topic (e.g., conversation.user.created) |
| `id` | string | Unique notification ID |
| `app_id` | string | Your Intercom app ID |
| `created_at` | number | Unix timestamp when the event occurred |
| `delivery_attempts` | number | Number of delivery attempts for this notification |
| `first_sent_at` | number | Unix timestamp of first delivery attempt |
| `data` | json | Event data containing the contact object. Access via data.item for contact details including id, role, email, name, phone, external\_id, custom\_attributes, location, avatar, tags, companies, and timestamps |

***

### Intercom Webhook (All Events) [#intercom-webhook-all-events]

Trigger workflow on any Intercom webhook event

#### Configuration [#configuration-5]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |

#### Output [#output-36]

| Parameter | Type | Description |
| - | - | - |
| `topic` | string | The webhook topic (e.g., conversation.user.created) |
| `id` | string | Unique notification ID |
| `app_id` | string | Your Intercom app ID |
| `created_at` | number | Unix timestamp when the event occurred |
| `delivery_attempts` | number | Number of delivery attempts for this notification |
| `first_sent_at` | number | Unix timestamp of first delivery attempt |
| `data` | json | Event data containing the affected object. Access via data.item for the resource (conversation, contact, company, ticket, etc.) |