Intercom

You 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.

You can tag a specific contact. This will return a tag object for the tag that was added to the contact.

Tool to archive a single contact in Intercom. Use when you need to archive a contact by their ID.

Assigns a conversation to a specific admin or team in Intercom

You can attach a company to a single contact.

Tool to attach a contact participant to a conversation on behalf of admin or contact. Use when you need to add a new participant to an existing conversation.

Tool to add a tag to a specific conversation in Intercom. Use when you need to attach or tag a conversation.

Tool to add a tag to a ticket in Intercom. Use when you need to attach or add a specific tag to a ticket for categorization or tracking purposes.

Tool to block a single contact in Intercom. Use when you need to block a contact, which will also archive their conversations.

Tool to cancel an active content data export job. Use when you need to terminate an ongoing export and update its status to 'canceled'.

Closes a conversation in Intercom, marking it as resolved

You can create a new collection by making a POST request to `https://api.intercom.io/help_center/collections.`

You can create a new article by making a POST request to `https://api.intercom.io/articles`.

You can add a note to a single contact.

Tool 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.

Tool to create a new content import source for the Fin Content Library. Use when you need to create a container for External Pages to be ingested into Intercom's AI content system.

Creates a new conversation in Intercom

Tool 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.

Tool 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.

Tool 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.

Tool 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.

Tool 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.

Tool to create a new internal article for team knowledge sharing. Use when you need to add new internal documentation or knowledge base articles for team members.

You 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 %}

Tool to create or update a tag, and optionally tag/untag companies or tag contacts. Use when you need to create a new tag, update an existing tag, or apply/remove tags to/from companies or users.

Tool 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.

Tool to create a new ticket type that defines the data structure for tracking customer requests. Use when you need to establish a new category of tickets with specific fields and states.

Tool 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.

Tool to create an export job for message data within a specified timeframe. Use when you need to export messages sent during a specific period. Only one active job per workspace is allowed at a time.

Tool to create event summaries for a user to track event occurrences. Use when you need to bulk update event counts for a user.

You can delete a single collection by making a DELETE request to `https://api.intercom.io/collections/<id>`.

You can delete a single company.

You can delete a single contact.

You can delete a single article by making a DELETE request to `https://api.intercom.io/articles/<id>`.

Tool to delete a tag from Intercom workspace. Use when you need to permanently remove a tag that is no longer needed.

Tool to delete a visitor from the Intercom workspace. Use when you need to permanently remove a visitor record.

Tool to delete a content import source and all its external pages. Use when you need to remove a content import source from Intercom. This operation is permanent and cannot be undone.

Tool to delete an external page from content library and AI answers. Use when you need to remove an external page from Intercom's AI knowledge base.

Tool to delete a single internal article by ID. Use when you need to permanently remove an internal article from Intercom.

Tool to delete a tag from workspace by ID. Use when you need to permanently remove a tag that is no longer needed.

Tool to delete a ticket from the Intercom system. Use when you need to permanently remove a ticket.

Tool to remove a tag from a specific contact in Intercom. Use when you need to detach or untag a contact.

You can detach a company from a single contact.

Tool to detach a contact from a company in Intercom. Use when you need to remove a company association from a contact.

Tool to remove a tag from a specific conversation in Intercom. Use when you need to detach or untag a conversation.

Tool to remove a tag from a ticket in Intercom. Use when you need to detach or remove a specific tag from a ticket.

Tool 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.

Tool 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.

Tool to retrieve details for a specific tag by its ID. Use when you need to get information about a particular tag in the workspace.

You can fetch the details of a single contact.

Tool to retrieve a content import source by its ID. Use when you need to fetch details about a specific content import source from Intercom's AI features.

Retrieves a specific conversation by ID with all messages and details

Tool 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.

Tool 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.

Tool to retrieve data from a completed reporting data export job. Returns a gzipped CSV file with exported data. Jobs expire two days after completion.

Tool to retrieve an external page from Fin Content Library by ID. Use when you need to fetch details of a specific external page including its content, metadata, and AI availability settings.

Tool to retrieve a ticket from Intercom. Use when you need to fetch comprehensive details about a specific ticket including state, type, attributes, and contacts.

Tool to retrieve details for a specific ticket type by its ID. Use when you need to get complete information about a ticket type including its attributes and states.

You 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.

Tool to retrieve the status of job execution. Use when checking progress and outcome of asynchronous operations like data imports or exports.

You can get a log of activities by all admins in an app.

You can fetch a list of admins for a given workspace.

You can fetch a list of all articles by making a GET request to `https://api.intercom.io/articles`. > 📘 How are the articles sorted and ordered? > > Articles will be returned in descending order on the `updated_at` attribute. This means if you need to iterate through results then we'll show the most recently updated articles first.

You can fetch a list of all collections by making a GET request to `https://api.intercom.io/help_center/collections`. Collections will be returned in descending order on the `updated_at` attribute. This means if you need to iterate through results then we'll show the most recently updated collections first.

You can list companies. The company list is sorted by the `last_request_at` field and by default is ordered descending, most recently requested first. Note that the API does not include companies who have no associated users in list responses. When using the Companies endpoint and the pages object to iterate through the returned companies, there is a limit of 10,000 Companies that can be returned. If you need to list or iterate on more than 10,000 Companies, please use the [Scroll API](https://developers.intercom.com/reference#iterating-over-all-companies). {% admonition type="warning" name="Pagination" %} You can use pagination to limit the number of results returned. The default is `20` results per page. See the [pagination section](https://developers.intercom.com/docs/build-an-integration/learn-more/rest-apis/pagination/#pagination-for-list-apis) for more details on how to use the `starting_after` param. {% /admonition %}

You can list all Help Centers by making a GET request to `https://api.intercom.io/help_center/help_centers`.

You can fetch a list of notes that are associated to a contact.

You can fetch a list of companies that are associated to a contact.

You can fetch a list of all contacts that belong to a company.

You can fetch a list of all segments that belong to a company.

You can fetch a list of segments that are associated to a contact.

Tool to retrieve all away status reasons for a workspace including deleted ones. Use when you need to list available away status options for team members.

Tool to list all phone calls from Intercom with pagination support. Use when you need to retrieve call records, view call history, or iterate through calls.

Tool 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.

Tool 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.

Tool to retrieve all content import sources for the workspace. Use when you need to list all content sources for Fin Content Library.

Lists conversations from Intercom with filtering and pagination support

Tool to list all data attributes for contacts, companies, and conversations. Use when you need to retrieve metadata about available data attributes.