Intercom
Manage contacts, companies, conversations, tickets, and messages in Intercom
Supercharge your customer communications and relationship management with Intercom – the all-in-one messaging platform for engaging, supporting, and retaining your customers. Integrate Intercom into your workflows to centralize conversations, contacts, support tickets, and more, all seamlessly accessible via automation.
With the Intercom tool, you can:
- Create and manage contacts: Easily add, update, search, list, and delete contacts to maintain a clean, actionable customer database.
- Organize companies: Create, get, and list companies to understand and support your customer organizations at scale.
- Centralize customer conversations: Retrieve, list, reply to, and search customer conversations to ensure no message slips through the cracks and support responses are always timely.
- Manage tickets and messages: Create and fetch tickets, as well as compose outbound messages, to deliver proactive, high-quality support experiences.
- Automate and extend workflows: Connect Intercom operations with your automations to trigger follow-ups, orchestrate customer journeys, and sync data with your stack.
Intercom empowers sales, support, and success teams to deliver personalized, efficient, and scalable customer experiences—whether you need to onboard new users, troubleshoot issues, or engage your customer base in real time.
Drive deeper relationships, faster response times, and smarter workflows by integrating Intercom with your automated processes today.
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.
Create a new contact in Intercom with email, external_id, or role. Returns API-aligned fields only.
| 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 |
| Parameter | Type | Description |
|---|
contact | object | Created contact object |
↳ 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 |
↳ 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 |
↳ url | string | URL to fetch companies |
↳ data | array | Array of social profile objects |
↳ has_more | boolean | Whether there are more companies |
↳ total_count | number | Total number of companies |
↳ 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 |
↳ 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 |
Get a single contact by ID from Intercom. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
contactId | string | Yes | Contact ID to retrieve |
| 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 |
↳ 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 |
Update an existing contact in Intercom. Returns API-aligned fields only.
| 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 |
| 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 |
List all contacts from Intercom with pagination support
| 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 |
| 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 |
Search for contacts in Intercom using a query
| 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" |
| 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 |
Delete a contact from Intercom by ID. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
contactId | string | Yes | Contact ID to delete |
| Parameter | Type | Description |
|---|
id | string | ID of deleted contact |
deleted | boolean | Whether the contact was deleted |
Create or update a company in Intercom
| 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 |
| Parameter | Type | Description |
|---|
company | object | Created or updated company object |
↳ id | string | Unique identifier for the company |
↳ type | string | Segment 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 |
↳ tags | array | Array of tag objects |
↳ segments | array | Array of segment objects |
companyId | string | ID of the created/updated company |
Retrieve a single company by ID from Intercom
| Parameter | Type | Required | Description |
|---|
companyId | string | Yes | Company ID to retrieve |
| 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 |
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.
| 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) |
| 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 |
Retrieve a single conversation by ID from Intercom
| 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 |
| 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 |
List all conversations from Intercom with pagination support
| 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) |
| 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 |
Reply to a conversation as an admin in Intercom
| 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. |
| 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 |
Search for conversations in Intercom using a query. Returns API-aligned fields only.
| 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" |
| 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 |
Create a new ticket in Intercom. Returns API-aligned fields only.
| 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 |
| 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 |
Retrieve a single ticket by ID from Intercom. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
ticketId | string | Yes | Ticket ID to retrieve |
| 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 |
Create and send a new admin-initiated message in Intercom. Returns API-aligned fields only.
| 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. |
| 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 |
