- Category: customer support
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 133
- Triggers: 0
- Slug:
INTERCOM - Version: 20261101_00
Tools
Add subscription to a contact
Add subscription to a contact
INTERCOM_ADD_SUBSCRIPTION_TO_A_CONTACTYou can add a specific subscription to a contact. In Intercom, we have two different subscription types based on user consent - opt-out and opt-in: 1.Attaching a contact to an opt-out subscription type will opt that user out from receiving messages related to that subscription type. 2.Attaching a contact to an opt-in subscription type will opt that user in to receiving messages related to that subscription type. This will return a subscription type model for the subscription type that was added to the contact.Input Parameters
Output
Add tag to contact
Add tag to contact
Archive contact
Archive contact
Assign conversation
Assign conversation
Attach contact to company
Attach contact to company
Attach contact to conversation
Attach contact to conversation
Attach tag to conversation
Attach tag to conversation
Attach tag to ticket
Attach tag to ticket
Block contact
Block contact
Cancel data export
Cancel data export
Close conversation
Close conversation
INTERCOM_CLOSE_CONVERSATIONCloses an Intercom conversation as an admin, optionally including a closing message. Closing requires a separate reopen action to reverse.Input Parameters
Output
Create a collection
Create a collection
INTERCOM_CREATE_A_COLLECTIONYou can create a new collection by making a POST request to https://api.intercom.io/help_center/collections.Input Parameters
null then it will be created as the first level collection.null then it will be created in the default help center.Output
Create an article
Create an article
INTERCOM_CREATE_AN_ARTICLEYou can create a new article by making a POST request to https://api.intercom.io/articles.Input Parameters
published or will be a draft. Defaults to draft. For multilingual articles, this will be the state of the default language”s content.Output
Create a note
Create a note
Create contact
Create contact
INTERCOM_CREATE_CONTACTTool to create a new contact in Intercom workspace. Use when you need to add a user or lead to Intercom. At least one identifier (email, external_id, or role) must be provided.Input Parameters
Output
Create content import source
Create content import source
Create conversation
Create conversation
INTERCOM_CREATE_CONVERSATIONCreates a new Intercom conversation from a user or contact. At least one user or contact ID is required; if both are supplied, the user ID takes precedence.Input Parameters
Output
Create data attribute
Create data attribute
INTERCOM_CREATE_DATA_ATTRIBUTETool to create a custom data attribute for contacts or companies. Use when you need to define a new attribute to track additional information beyond standard fields.Input Parameters
Output
Create data event
Create data event
INTERCOM_CREATE_DATA_EVENTTool to submit a data event to Intercom to track user activities. Use when you need to notify Intercom of user actions and changes. Events are detected as duplicates using workspace ID, contact identifier, event name, and timestamp.Input Parameters
Output
Create data export
Create data export
INTERCOM_CREATE_DATA_EXPORTTool to initiate an async data export job for message content. Use when you need to export messages created within a specific timeframe. Only one active job per workspace is allowed; exceeding this limit triggers a 429 error. Jobs expire two days after completion.Input Parameters
Output
Create external page
Create external page
INTERCOM_CREATE_EXTERNAL_PAGETool to create an external page in Fin Content Library or update an existing page by external ID. Use when you need to ingest new content or update existing content for AI-generated answers. Supports upsert behavior: if a page with the same source_id and external_id exists, it will be updated instead of creating a new one.Input Parameters
Output
Create help center section
Create help center section
INTERCOM_CREATE_HELP_CENTER_SECTIONTool to create a new help center section within a collection. Use when you need to add a new section to organize articles in the help center hierarchy (Help Center → Collections → Sections → Articles). Supports multilingual content via translated_content parameter.Input Parameters
Output
Create internal article
Create internal article
Create or update a company
Create or update a company
INTERCOM_CREATE_OR_UPDATE_A_COMPANYYou can create or update a company. Companies will be only visible in Intercom when there is at least one associated user. Companies are looked up via company_id in a POST request, if not found via company_id, the new company will be created, if found, that company will be updated. {% admonition type=“attention” name=“Using company_id” %} You can set a unique company_id value when creating a company. However, it is not possible to update company_id. Be sure to set a unique value once upon creation of the company. {% /admonition %}Input Parameters
Output
Create or update tag
Create or update tag
INTERCOM_CREATE_TAGCreate or update a tag, optionally applying or removing it from companies or applying it to users.Input Parameters
Output
Create ticket
Create ticket
INTERCOM_CREATE_TICKETTool to create a ticket in Intercom to track customer requests and issues. Use when you need to create a new support ticket with specified type, contacts, and attributes.Input Parameters
Output
Create a ticket type
Create a ticket type
Create ticket type attribute
Create ticket type attribute
INTERCOM_CREATE_TICKET_TYPE_ATTRIBUTETool to create a new attribute for a ticket type in Intercom. Use when you need to add custom attributes to ticket types for data collection.Input Parameters
Output
Create event summaries
Create event summaries
Delete a collection
Delete a collection
Delete a company
Delete a company
Delete an article
Delete an article
Delete a tag
Delete a tag
Delete a visitor
Delete a visitor
Delete a contact
Delete a contact
Delete content import source
Delete content import source
Delete conversation
Delete conversation
Delete external page
Delete external page
Delete internal article
Delete internal article
Delete ticket
Delete ticket
Detach a contact from tag
Detach a contact from tag
Detach contact from company
Detach contact from company
Detach tag from conversation
Detach tag from conversation
Detach tag from ticket
Detach tag from ticket
Download data export
Download data export
INTERCOM_DOWNLOAD_DATA_EXPORTTool to download content data export from Intercom. Use when you need to retrieve exported message data from a completed data export job. The data is returned as a gzipped CSV file stream.Input Parameters
Output
Enqueue create ticket
Enqueue create ticket
INTERCOM_ENQUEUE_CREATE_TICKETTool to enqueue ticket creation for asynchronous processing. Use when you need to create a ticket in Intercom. The system attempts validation on inputs before tasks are enqueued.Input Parameters
Output
Export workflow
Export workflow
Find a tag
Find a tag
Get a contact
Get a contact
Get content import source
Get content import source
Get conversation
Get conversation
INTERCOM_GET_CONVERSATIONRetrieves an Intercom conversation by ID, including its returned messages and details. The response can contain at most 500 conversation parts; this tool does not provide a cursor for fetching further parts.Input Parameters
subject and custom_attributes may still contain raw HTML — sanitize separately.Output
Get entity counts
Get entity counts
INTERCOM_GET_COUNTSTool to retrieve summary counts for Intercom app entities including companies, users, leads, tags, segments, and conversations. Use when you need to get statistics about the total number of entities in the workspace or conversation counts.Input Parameters
Output
Get custom object instance by external ID
Get custom object instance by external ID
INTERCOM_GET_CUSTOM_OBJECT_INSTANCE_BY_EXTERNAL_IDTool to retrieve a custom object instance by its external_id. Use when you need to fetch a specific custom object instance from Intercom using an identifier from your external system rather than Intercom’s internal ID.Input Parameters
Output
Get external page
Get external page
Get ticket
Get ticket
Get a ticket type
Get a ticket type
Identify an admin
Identify an admin
INTERCOM_IDENTIFY_AN_ADMINYou can view the currently authorised admin along with the embedded app object (a “workspace” in legacy terminology). > 🚧 Single Sign On > > If you are building a custom “Log in with Intercom” flow for your site, and you call the /me endpoint to identify the logged-in user, you should not accept any sign-ins from users with unverified email addresses as it poses a potential impersonation security risk.Output
Retrieve job status
Retrieve job status
List all activity logs
List all activity logs
List all admins
List all admins
List all articles
List all articles
List all collections
List all collections
List all companies
List all companies
List all help centers
List all help centers
List all macros
List all macros
INTERCOM_LIST_ALL_MACROSTool to fetch a list of all macros (saved replies) in your workspace for use in automating responses. The macros are returned in descending order by updated_at. Use when you need to retrieve available macros or sync macro data.Input Parameters
Output
List all notes
List all notes
List attached companies for contact
List attached companies for contact
List attached contacts
List attached contacts
List attached segments for companies
List attached segments for companies
List attached segments for contact
List attached segments for contact
List away status reasons
List away status reasons
List calls
List calls
List calls with transcripts
List calls with transcripts
INTERCOM_LIST_CALLS_WITH_TRANSCRIPTSTool to retrieve calls by conversation IDs with transcripts when available. Use when you need to get call records with their transcripts for specific conversations. Maximum 20 conversation IDs per request.Input Parameters
Output
List company notes
List company notes
List all contacts
List all contacts
INTERCOM_LIST_CONTACTSTool to list all contacts (users or leads) in your Intercom workspace with pagination support. Use when you need to retrieve multiple contacts or iterate through all contacts in the workspace.Input Parameters
Output
List content import sources
List content import sources
List conversations
List conversations
List data attributes
List data attributes
List data events
List data events
INTERCOM_LIST_DATA_EVENTSList data events belonging to a specific customer, with optional event summaries. Only events less than 90 days old can be listed; results are collected from at most 50 pages and may be incomplete.Input Parameters
Output
List external pages
List external pages
List help center sections
List help center sections
List internal articles
List internal articles
INTERCOM_LIST_INTERNAL_ARTICLESFetches one page of internal articles from Intercom. Uses Intercom’s cursor-based pagination via starting_after. ONE Intercom API call is made per invocation; pagination is caller-driven via the starting_after request parameter and the next_starting_after field in the response.Input Parameters
next_starting_after value from a previous response to fetch the next page.Output
List all news items
List all news items
List all segments
List all segments
INTERCOM_LIST_SEGMENTSList segments in an Intercom workspace, optionally requesting contact counts. The response may include pagination metadata; this action retrieves one page per request.Input Parameters
Output
List subscriptions for a contact
List subscriptions for a contact
INTERCOM_LIST_SUBSCRIPTIONS_FOR_A_CONTACTYou can fetch a list of subscription types that are attached to a contact. These can be subscriptions that a user has ‘opted-in’ to or has ‘opted-out’ from, depending on the subscription type. This will return a list of Subscription Type objects that the contact is associated with. The data property will show a combined list of: 1.Opt-out subscription types that the user has opted-out from. 2.Opt-in subscription types that the user has opted-in to receiving.Input Parameters
Output
List subscription types
List subscription types
List all teams
List all teams
List all ticket states
List all ticket states
List all ticket types
List all ticket types
Merge a lead and a user
Merge a lead and a user
Redact conversation content
Redact conversation content
Register Fin Voice call
Register Fin Voice call
INTERCOM_REGISTER_FIN_VOICE_CALLTool to register a Fin Voice call with Intercom. Use when you need to create a record of an external voice call in Intercom, enabling AI-powered call analysis and customer interaction tracking.Input Parameters
Output
Remove subscription from a contact
Remove subscription from a contact
Remove tag from a contact
Remove tag from a contact
Reopen conversation
Reopen conversation
Retrieve a collection
Retrieve a collection
Retrieve a company by id
Retrieve a company by id
Retrieve a help center
Retrieve a help center
Retrieve job status
Retrieve job status
Retrieve a macro
Retrieve a macro
Retrieve an admin
Retrieve an admin
Retrieve an article
Retrieve an article
Retrieve a segment
Retrieve a segment
INTERCOM_RETRIEVE_A_SEGMENTTool to retrieve details for a single segment by its ID. Use when you need to get information about a specific segment including its name, type, and optionally the count of items.Input Parameters
Output
Retrieve companies
Retrieve companies
INTERCOM_RETRIEVE_COMPANIESYou can fetch a single company by passing in company_id or name. https://api.intercom.io/companies?name={name} https://api.intercom.io/companies?company_id={company_id} You can fetch all companies and filter by segment_id or tag_id as a query parameter. https://api.intercom.io/companies?tag_id={tag_id} https://api.intercom.io/companies?segment_id={segment_id}Input Parameters
Output
Retrieve internal article
Retrieve internal article
Retrieve note
Retrieve note
Retrieve a team
Retrieve a team
Retrieve visitor with user ID
Retrieve visitor with user ID
Scroll over all companies
Scroll over all companies
INTERCOM_SCROLL_OVER_ALL_COMPANIESThe list all companies functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply. The Scroll API provides an efficient mechanism for iterating over all companies in a dataset. - Each app can only have 1 scroll open at a time. You’ll get an error message if you try to have more than one open per app. You can get the first page of companies by simply sending a GET request to the scroll endpoint. For subsequent requests you will need to use the scroll parameter from the response type=“danger” name=“Scroll network timeouts”. Since scroll is often used on large datasets network errors such as timeouts can be encountered. When this occurs you will see a HTTP 500 error with the following message: “Request failed due to an internal network error. Please restart the scroll operation.” If this happens, you will need to restart your scroll query.Input Parameters
Output
Search contacts
Search contacts
INTERCOM_SEARCH_CONTACTSSearches Intercom contacts using query filters and operators, including filters for role, email, name, or attributes. Results support pagination and may contain nullable contact fields.Input Parameters
Output
Search conversations
Search conversations
INTERCOM_SEARCH_CONVERSATIONSSearches for conversations using query string with support for filtering and sortingInput Parameters
Output
Search for articles
Search for articles
Search internal articles
Search internal articles
INTERCOM_SEARCH_INTERNAL_ARTICLESSearches one page of internal articles in Intercom. Uses Intercom’s cursor-based pagination via starting_after. ONE Intercom API call is made per invocation; pagination is caller-driven via the starting_after request parameter and the next_starting_after field in the response. Optionally filtered by folder_id.Input Parameters
next_starting_after value from a previous response to fetch the next page.Output
Search tickets
Search tickets
INTERCOM_SEARCH_TICKETSTool to search tickets in Intercom by filtering attribute values. Use when you need to find tickets matching specific criteria like state, creation date, assignment, or custom attributes.Input Parameters
Output
Send outbound message
Send outbound message
INTERCOM_SEND_OUTBOUND_MESSAGESends an immediate, irreversible admin-initiated in-app, email, or WhatsApp message.Input Parameters
Output
Set admin to away
Set admin to away
Set an admin to away
Set an admin to away
Show call
Show call
Show call transcript
Show call transcript
Show contact by external ID
Show contact by external ID
INTERCOM_SHOW_CONTACT_BY_EXTERNAL_IDTool to retrieve a contact by their external ID. Use when you need to fetch contact details using an identifier from your external system rather than Intercom’s internal ID. Only supports users, not leads.Input Parameters
Output
Unarchive contact
Unarchive contact
Update a collection
Update a collection
INTERCOM_UPDATE_A_COLLECTIONUpdate the details of a single collection by ID using a PUT request to /help_center/collections/{id}.Input Parameters
null then it will be updated as the first level collection.Output
Update a company
Update a company
INTERCOM_UPDATE_A_COMPANYYou can update a single company using the Intercom provisioned id. {% admonition type=“attention” name=“Using company_id” %} When updating a company it is not possible to update company_id. This can only be set once upon creation of the company. {% /admonition %}Input Parameters
Output
Update a contact
Update a contact
INTERCOM_UPDATE_A_CONTACTUpdate an existing contact (user or lead). Optionally attach companies after the update; attachment outcomes are reported in the execution message.Input Parameters
Output
Update an article
Update an article
INTERCOM_UPDATE_AN_ARTICLEYou can update the details of a single article by making a PUT request to https://api.intercom.io/articles/<id>.Input Parameters
published or will be a draft. Defaults to draft. For multilingual articles, this will be the state of the default language”s content.Output
Update contact
Update contact
Update content import source
Update content import source
INTERCOM_UPDATE_CONTENT_IMPORT_SOURCETool to update an existing content import source in Fin Content Library. Use when you need to modify the URL, sync behavior, or status of an existing content import source.Input Parameters
Output
Update conversation
Update conversation
Update data attribute
Update data attribute
INTERCOM_UPDATE_DATA_ATTRIBUTEUpdate an existing Intercom data attribute’s description, archive status, Messenger writability, or predefined options. Changing the attribute’s type is not supported by this tool.Input Parameters
Output
Update external page
Update external page
INTERCOM_UPDATE_EXTERNAL_PAGETool to update an existing external page in Fin Content Library. Use when you need to modify the content, metadata, or availability settings of an external page. Only pages created through the API can be updated.Input Parameters
Output
Update internal article
Update internal article
Update ticket
Update ticket
INTERCOM_UPDATE_TICKETTool to update an existing ticket in Intercom. Use when you need to modify ticket attributes, state, assignment, or other properties.Input Parameters
Output
Update a ticket type
Update a ticket type