Intercom

Configuration

Create Contact

Operation

Create Contact

Access Token*

••••••••

Role

Select...

Contact email

External ID

External identifier for the contact

Phone

Contact phone number

Name

Contact name

Avatar URL

Avatar image URL

Signed Up At

Unix timestamp

Last Seen At

Unix timestamp

Owner ID

Admin ID

Unsubscribed from Emails

Select...

Custom Attributes

JSON object with custom attributes

Company ID

Company ID to associate with contact

Create Contact (intercom_create_contact)

Create a new contact in Intercom with email, external_id, or role

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

Parameter	Type	Description
`id`	string	Unique identifier for the contact
`type`	string	List type
`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
`url`	string	URL to fetch tags
`data`	array	Array of tag objects
`has_more`	boolean	Whether there are more tags

Get Contact

Operation

Get Contact

Access Token*

••••••••

Contact ID*

Contact ID

Get Contact (intercom_get_contact)

Get a single contact by ID from Intercom

Input

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

Output

Parameter	Type	Description
`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

Update Contact

Operation

Update Contact

Access Token*

••••••••

Role

Select...

Contact ID*

Contact ID

Contact email

External ID

External identifier for the contact

Phone

Contact phone number

Name

Contact name

Avatar URL

Avatar image URL

Signed Up At

Unix timestamp

Last Seen At

Unix timestamp

Owner ID

Admin ID

Unsubscribed from Emails

Select...

Custom Attributes

JSON object with custom attributes

Company ID

Company ID to associate with contact

Update Contact (intercom_update_contact)

Update an existing contact in Intercom

Input

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

Parameter	Type	Description
`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

List Contacts

Operation

List Contacts

Access Token*

••••••••

Per Page

Results per page (max: 150)

Starting After

Cursor for pagination

List Contacts (intercom_list_contacts)

List all contacts from Intercom with pagination support

Input

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

Parameter	Type	Description
`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

Search Contacts

Operation

Search Contacts

Access Token*

••••••••

Search Query*

JSON search query or text

Sort Field

Field to sort by (e.g., name, created_at)

Sort Order

Select...

Per Page

Results per page (max: 150)

Starting After

Cursor for pagination

Search Contacts (intercom_search_contacts)

Search for contacts in Intercom using a query

Input

Parameter	Type	Required	Description
`query`	string	Yes	Search query (e.g., {"field":"email","operator":"=","value":"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

Parameter	Type	Description
`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

Delete Contact

Operation

Delete Contact

Access Token*

••••••••

Contact ID*

Contact ID

Delete Contact (intercom_delete_contact)

Delete a contact from Intercom by ID

Input

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

Output

Parameter	Type	Description
`id`	string	ID of deleted contact
`deleted`	boolean	Whether the contact was deleted

Create Company

Operation

Create Company

Access Token*

••••••••

Company ID (External)*

Your unique identifier for the company

Company Name

Company name

Website

Company website

Plan

Subscription plan

Size

Number of employees

Industry

Company industry

Monthly Spend

Revenue amount

Remote Created At

Unix timestamp when company was created

Create Company (intercom_create_company)

Create or update a company in Intercom

Input

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

Parameter	Type	Description
`id`	string	Unique identifier for the company
`type`	string	Tag list type
`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

Get Company

Operation

Get Company

Access Token*

••••••••

Company ID*

Intercom company ID

Get Company (intercom_get_company)

Retrieve a single company by ID from Intercom

Input

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

Output

Parameter	Type	Description
`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

List Companies

Operation

List Companies

Access Token*

••••••••

Per Page

Results per page (max: 150)

Starting After

Cursor for pagination

Page

Page number

List Companies (intercom_list_companies)

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.

Input

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

Parameter	Type	Description
`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

Get Conversation

Operation

Get Conversation

Access Token*

••••••••

Conversation ID*

Conversation ID

Display As

Select...

Include Translations

Select...

Get Conversation (intercom_get_conversation)

Retrieve a single conversation by ID from Intercom

Input

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

Parameter	Type	Description
`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

List Conversations

Operation

List Conversations

Access Token*

••••••••

Sort By

Field to sort by (e.g., waiting_since, updated_at)

Order

Select...

Per Page

Results per page (max: 150)

Starting After

Cursor for pagination

List Conversations (intercom_list_conversations)

List all conversations from Intercom with pagination support

Input

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

Parameter	Type	Description
`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

Reply to Conversation

Operation

Reply to Conversation

Access Token*

••••••••

Conversation ID*

Conversation ID

Message Type*

Select...

Message Body*

Message text

Admin ID*

ID of the admin sending the message

Attachment URLs

Comma-separated image URLs (max 10)

Created At

Unix timestamp for reply creation time

Reply to Conversation (intercom_reply_conversation)

Reply to a conversation as an admin in Intercom

Input

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

Parameter	Type	Description
`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

Search Conversations

Operation

Search Conversations

Access Token*

••••••••

Search Query*

JSON search query or text

Sort Field

Field to sort by (e.g., name, created_at)

Sort Order

Select...

Per Page

Results per page (max: 150)

Starting After

Cursor for pagination

Search Conversations (intercom_search_conversations)

Search for conversations in Intercom using a query

Input

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

Parameter	Type	Description
`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

Create Ticket

Operation

Create Ticket

Access Token*

••••••••

Ticket Type ID*

ID of the ticket type

Contacts*

JSON array of contact identifiers

Ticket Attributes*

JSON object with ticket attributes

Company ID

Company ID to associate with ticket

Created At

Unix timestamp for ticket creation time

Conversation to Link

ID of conversation to link to ticket

Disable Notifications

Select...

Create Ticket (intercom_create_ticket)

Create a new ticket in Intercom

Input

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

Parameter	Type	Description
`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

Get Ticket

Operation

Get Ticket

Access Token*

••••••••

Ticket ID*

Ticket ID

Get Ticket (intercom_get_ticket)

Retrieve a single ticket by ID from Intercom

Input

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

Output

Parameter	Type	Description
`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

Create Message

Operation

Create Message

Access Token*

••••••••

Message Body*

Message text

Message Type*

Select...

Template*

Select...

Subject

Email subject (for email type)

From Type*

Select...

From ID*

Admin ID

To Type*

Select...

To ID*

Contact ID

Created At

Unix timestamp for message creation time

Create Message (intercom_create_message)

Create and send a new admin-initiated message in Intercom

Input

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

Parameter	Type	Description
`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

Usage Instructions

Integrate Intercom into the workflow. Can create, get, update, list, search, and delete contacts; create, get, and list companies; get, list, reply, and search conversations; create and get tickets; and create messages.

Notes

Category: tools
Type: intercom

Intercom

On this page