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

You can fetch a list of notes 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.

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 notes associated with a specific company. Use when you need to retrieve all notes that have been added to a company record.

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 all conversations from Intercom with pagination support. This endpoint does not support filtering by state, assignee, or other attributes - use INTERCOM_SEARCH_CONVERSATIONS for filtering. Paginate by reading pages.next.starting_after from each response and passing it as starting_after until pages.next is absent. Response fields including title, source.body, conversation_parts.body, and statistics may be null; guard before string operations.

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

Tool to retrieve a log of data events belonging to a customer. Use when you need to list events for a specific user. Note: Only events less than 90 days old can be listed.

Tool to list all external pages from Fin Content Library. Use when you need to retrieve external pages used for AI-generated answers in Intercom.

Tool to fetch a list of all help center sections in descending order by updated_at. Use when you need to retrieve sections from the help center hierarchy (Help Center → Collections → Sections → Articles).

Tool to list all internal articles in Intercom. Use when you need to retrieve all internal articles available in the workspace.

Tool to fetch a list of all news items from Intercom. Use when you need to retrieve news items posted in the workspace.

Tool to retrieve all segments defined within a workspace for filtering and categorizing contacts. Use when you need to get a list of all available segments or check segment counts.

Tool to list all subscription types available in the workspace. Use when you need to retrieve subscription configuration details including state, translations, consent type, and supported content types.

Tool to fetch all tags for the workspace. Use when you need to retrieve all available tags that can be applied to contacts, companies, and conversations.

Tool to retrieve all teams within a workspace. Use when you need to get a list of all available teams, their members, or assignment configurations.

Tool to fetch all ticket states for the workspace. Use when you need to retrieve all configured ticket states, including both active and archived ones.

Tool to retrieve all ticket types for the workspace. Use when you need to get all available ticket type configurations including attributes and states.

You can merge a contact with a role of lead into a contact with a role of user.

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

Reopens a closed conversation in Intercom. Only operates correctly on conversations in a closed state; verify state via INTERCOM_GET_CONVERSATION before calling, as using on open or snoozed conversations may produce unexpected results.

Tool to reply to a ticket with a message from admin or contact, or with a note for admins. Use when you need to add a response or comment to an existing ticket.

Sends a reply to an existing conversation in Intercom. Always send reply before closing a conversation — never parallelize with INTERCOM_CLOSE_CONVERSATION on the same conversation. Verify conversation state via INTERCOM_GET_CONVERSATION before replying, as open/snoozed/closed states may diverge from cached values.

You can fetch a single company.

Tool to retrieve the status of a data export job. Use when checking the progress of an export job by providing the job identifier.

Tool to fetch a single macro (saved reply) by its ID. The macro will only be returned if it is visible to the authenticated user based on its visibility settings.

You can fetch the details of a single article by making a GET request to https://api.intercom.io/articles/<id>.

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

Tool to retrieve an internal article by ID from Intercom. Use when you need to fetch details of a specific internal article including its title, body content, and metadata.

Tool to retrieve details of a single note by its identifier. Use when you need to fetch the complete information about a specific note.

Tool to retrieve detailed information about a specific team by ID. Use when you need to get team details including members and assignment configuration.

Tool to retrieve a specific visitor's details using their user_id. Use when you need to fetch comprehensive visitor information including profile data, location, and activity metrics.

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

Tool to search for contacts using query filters with operators. Use when finding contacts by role, email, name, or attributes. Response entries may include null or non-dictionary values; guard against missing/null fields before accessing nested properties. A contact may have multiple emails or contact_ids; deduplicate when aggregating across searches.

Searches for conversations using query string with support for filtering and sorting

Tool to search for internal articles in Intercom. Use when you need to find internal articles, optionally filtered by folder ID.

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

Tool to set an admin to away status in Intercom. Use when you need to mark an admin as away, optionally with a specific reason and reassignment behavior.

Tool to retrieve a single call by ID from Intercom. Use when you need to get detailed information about a specific phone call.

Tool to get call transcript by call ID. Use when you need to retrieve the transcript text from a recorded call.

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

Tool to unarchive a previously archived contact in Intercom. Use when you need to restore an archived contact by their ID.

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

You can update the details of a single article by making a PUT request to https://api.intercom.io/articles/<id>.

Tool to update an existing contact in Intercom. Use when you need to modify contact information such as name, email, custom attributes, or other properties.

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

Tool to update an existing data attribute in Intercom. Use when you need to modify a data attribute's description, archive status, or messenger writability. Note: Changing a data attribute's type via the API is restricted and must be done through the UI.

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

Tool to update an internal article with new title, body, author or owner information. Use when you need to modify an existing internal article in Intercom.

Tool to update an existing ticket in Intercom. Use when you need to modify ticket attributes, state, assignment, or other properties.

Tool to update an existing ticket type in the workspace. Use when you need to modify a ticket type's name, description, category, icon, or archive status.

Tool to update an existing attribute for a ticket type. Use when you need to modify properties like description, visibility, or requirements for a ticket type attribute.

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 create a new collection by making a POST request to https://api.intercom.io/help_center/collections.

You can add a note to a single contact.

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.

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

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 all Help Centers by making a GET request to https://api.intercom.io/help_center/help_centers.

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

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

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

You can fetch a list of all tags that are attached to a specific contact.

You can remove a specific subscription from a contact. This will return a subscription type model for the subscription type that was removed from the contact.

You can remove tag from a specific contact. This will return a tag object for the tag that was removed from the contact.

You can fetch the details of a single collection by making a GET request to https://api.intercom.io/help_center/collections/<id>.

You can fetch the details of a single Help Center by making a GET request to https://api.intercom.io/help_center/help_center/<id>.

You can retrieve the details of a single admin.

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

You can search for articles by making a GET request to https://api.intercom.io/articles/search.

You can set an Admin as away for the Inbox.

You can update the details of a single collection by making a PUT request to https://api.intercom.io/collections/<id>.

You can update an existing contact (ie. user or lead).