Skip to main content
Server path: /intercom | Type: Application | PCID required: Yes Intercom integration for Fin AI agent, conversations, contacts, knowledge management, notes, tags, and tickets

Tools

ToolDescription
intercom_start_fin_conversationStart a new Fin conversation on behalf of a user. Sends an initial user message and optional user/context data into Fin. Returns the Fin conversation ID, current status, reply HTML, and metadata.
intercom_send_fin_replyContinue an existing Fin conversation by sending a follow-up user message. Returns updated status, reply HTML, and metadata.
intercom_get_fin_conversation_metadataRetrieve metadata for a Fin conversation (state, tags, ai_agent, contacts, etc.). Use the Intercom conversation ID returned by intercom_start_fin_conversation or intercom_send_fin_reply.
intercom_list_fin_content_sourcesList content sources used by Fin for knowledge.
intercom_create_fin_content_sourceCreate a new content source for Fin knowledge.
intercom_update_fin_content_sourceUpdate an existing content source for Fin.
intercom_list_fin_external_pagesList external pages (documents) Fin can use as knowledge. Optionally filter by source ID or external ID.
intercom_upsert_fin_external_pageCreate or update an External Page used by Fin for knowledge. Uses the external_id as a stable identifier for upsert behavior.
intercom_delete_fin_external_pageDelete an External Page from Fin knowledge.
intercom_list_conversationsList Intercom conversations with optional sorting and pagination.
intercom_search_conversationsSearch Intercom conversations using a query object with filters for attributes, tags, date ranges, assignees, and state.
intercom_get_conversationFetch full details for an Intercom conversation including parts, participants, tags, and stats.
intercom_reply_to_conversationPost a reply into an existing Intercom conversation.
intercom_create_conversationOpen a new Intercom conversation with a contact.
intercom_list_contactsList Intercom contacts with pagination.
intercom_search_contactsSearch Intercom contacts by attributes such as name, email, phone, tags, and custom properties.
intercom_get_contactRetrieve a single Intercom contact with full details including custom attributes and activity.
intercom_create_or_update_contactUpsert an Intercom contact by email or external ID. Creates a new contact if none exists, or updates the existing one.
intercom_delete_contactDelete an Intercom contact by ID.
intercom_list_contact_notesList notes attached to an Intercom contact.
intercom_create_contact_noteAttach a note to an Intercom contact (e.g., a summary from Fin or internal context).
intercom_add_tag_to_conversationApply a tag to an Intercom conversation for routing, analytics, or categorization. Requires the Intercom tag ID (from list tags or conversation tag objects).
intercom_remove_tag_from_conversationRemove a tag from an Intercom conversation. Requires the Intercom tag ID (from the conversation’s tags).
intercom_create_ticketCreate a structured ticket. Requires Intercom Tickets to be enabled. Title and description are sent as default_title and default_description under ticket_attributes.
intercom_update_ticketUpdate an existing Intercom ticket.
intercom_list_ticket_typesList all ticket types configured in the Intercom workspace. Useful for finding the ticket_type_id needed to create tickets.

intercom_start_fin_conversation

Start a new Fin conversation on behalf of a user. Sends an initial user message and optional user/context data into Fin. Returns the Fin conversation ID, current status, reply HTML, and metadata. Parameters:
ParameterTypeRequiredDefaultDescription
messagestringYesInitial user message to send to Fin
conversation_idstringNoExternal conversation ID to associate with this Fin conversation
userobjectNoUser identity
timestampstringNoISO 8601 timestamp of the message (e.g., 2025-01-24T10:01:20.000Z)

intercom_send_fin_reply

Continue an existing Fin conversation by sending a follow-up user message. Returns updated status, reply HTML, and metadata. Parameters:
ParameterTypeRequiredDefaultDescription
conversation_idstringYesIntercom conversation ID to continue
messagestringYesFollow-up user message
userobjectNoUser identity
timestampstringNoISO 8601 timestamp of the message (e.g., 2025-01-24T10:01:20.000Z)

intercom_get_fin_conversation_metadata

Retrieve metadata for a Fin conversation (state, tags, ai_agent, contacts, etc.). Use the Intercom conversation ID returned by intercom_start_fin_conversation or intercom_send_fin_reply. Parameters:
ParameterTypeRequiredDefaultDescription
conversation_idstringYesIntercom conversation ID (same ID returned by intercom_start_fin_conversation and intercom_send_fin_reply)

intercom_list_fin_content_sources

List content sources used by Fin for knowledge. Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of results per page

intercom_create_fin_content_source

Create a new content source for Fin knowledge. Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesName of the content source
descriptionstringNoDescription of the content source
configobjectNoConfiguration (audience, visibility, etc.)

intercom_update_fin_content_source

Update an existing content source for Fin. Parameters:
ParameterTypeRequiredDefaultDescription
source_idstringYesContent source ID to update
namestringNoUpdated name
descriptionstringNoUpdated description
configobjectNoUpdated configuration

intercom_list_fin_external_pages

List external pages (documents) Fin can use as knowledge. Optionally filter by source ID or external ID. Parameters:
ParameterTypeRequiredDefaultDescription
source_idstringNoFilter by content source ID
external_idstringNoFilter by external page ID
pagenumberNoPage number for pagination
per_pagenumberNoNumber of results per page

intercom_upsert_fin_external_page

Create or update an External Page used by Fin for knowledge. Uses the external_id as a stable identifier for upsert behavior. Parameters:
ParameterTypeRequiredDefaultDescription
external_idstringYesYour stable identifier for the page (used for upsert)
titlestringYesPage title
bodystringYesPage content (HTML or markdown)
urlstringNoSource URL of the page
source_idstringNoContent source ID this page belongs to
metadataobjectNoAdditional metadata

intercom_delete_fin_external_page

Delete an External Page from Fin knowledge. Parameters:
ParameterTypeRequiredDefaultDescription
external_idstringNoExternal ID of the page to delete
page_idstringNoIntercom page ID to delete (provide either external_id or page_id)

intercom_list_conversations

List Intercom conversations with optional sorting and pagination. Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of results per page
sortstringNoField to sort by (e.g., created_at, updated_at)
orderstringNoSort order

intercom_search_conversations

Search Intercom conversations using a query object with filters for attributes, tags, date ranges, assignees, and state. Parameters:
ParameterTypeRequiredDefaultDescription
queryobjectYesSearch query object with filters (attributes, tags, date ranges, etc.)
pagenumberNoPage number for pagination
per_pagenumberNoNumber of results per page

intercom_get_conversation

Fetch full details for an Intercom conversation including parts, participants, tags, and stats. Parameters:
ParameterTypeRequiredDefaultDescription
conversation_idstringYesConversation ID to retrieve

intercom_reply_to_conversation

Post a reply into an existing Intercom conversation. Parameters:
ParameterTypeRequiredDefaultDescription
conversation_idstringYesConversation ID to reply to
message_typestringYesMessage type (comment for user-visible reply, note for internal)
typestringYesAuthor type of the reply
bodystringYesReply message body (HTML supported)
intercom_user_idstringNoIntercom user ID of the author (required when type is “user”)
attachmentsobject[]NoFile attachments
metadataobjectNoAdditional metadata

intercom_create_conversation

Open a new Intercom conversation with a contact. Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringNoContact ID (provide contact_id or email)
emailstringNoContact email (provide contact_id or email)
bodystringYesInitial message body
fromobjectYesSender identity
metadataobjectNoAdditional metadata

intercom_list_contacts

List Intercom contacts with pagination. Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of results per page

intercom_search_contacts

Search Intercom contacts by attributes such as name, email, phone, tags, and custom properties. Parameters:
ParameterTypeRequiredDefaultDescription
queryobjectYesSearch query object with filters (properties, tags, etc.)
pagenumberNoPage number for pagination
per_pagenumberNoNumber of results per page

intercom_get_contact

Retrieve a single Intercom contact with full details including custom attributes and activity. Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYesContact ID to retrieve

intercom_create_or_update_contact

Upsert an Intercom contact by email or external ID. Creates a new contact if none exists, or updates the existing one. Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringNoExisting contact ID to update
emailstringNoContact email (used for matching)
external_idstringNoExternal ID (used for matching)
attributesobjectNoContact attributes to set (name, phone, custom_attributes, etc.)

intercom_delete_contact

Delete an Intercom contact by ID. Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYesContact ID to delete

intercom_list_contact_notes

List notes attached to an Intercom contact. Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYesContact ID to list notes for
pagenumberNoPage number for pagination
per_pagenumberNoNumber of results per page

intercom_create_contact_note

Attach a note to an Intercom contact (e.g., a summary from Fin or internal context). Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYesContact ID to attach the note to
bodystringYesNote content
metadataobjectNoAdditional metadata

intercom_add_tag_to_conversation

Apply a tag to an Intercom conversation for routing, analytics, or categorization. Requires the Intercom tag ID (from list tags or conversation tag objects). Parameters:
ParameterTypeRequiredDefaultDescription
conversation_idstringYesConversation ID to tag
tag_idstringYesIntercom tag ID (e.g. “7522907”)
admin_idstringNoIntercom admin ID (required by API if not injected by proxy)

intercom_remove_tag_from_conversation

Remove a tag from an Intercom conversation. Requires the Intercom tag ID (from the conversation’s tags). Parameters:
ParameterTypeRequiredDefaultDescription
conversation_idstringYesConversation ID to remove tag from
tag_idstringYesIntercom tag ID (e.g. “7522907”)
admin_idstringNoIntercom admin ID (required by API if not injected by proxy)

intercom_create_ticket

Create a structured ticket. Requires Intercom Tickets to be enabled. Title and description are sent as default_title and default_description under ticket_attributes. Parameters:
ParameterTypeRequiredDefaultDescription
ticket_type_idnumberYesTicket type ID (required, numeric). Find in Intercom Settings > Tickets > Ticket Types.
titlestringYesTicket title (sent as default_title)
descriptionstringYesTicket description (sent as default_description)
contactsobject[]NoArray of contacts to associate with the ticket
ticket_attributesobjectNoAdditional custom ticket attributes beyond title and description

intercom_update_ticket

Update an existing Intercom ticket. Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idstringYesTicket ID to update
statusstringNoUpdated ticket status
assignee_idstringNoAdmin/team ID to assign the ticket to
ticket_attributesobjectNoTicket attributes to update (e.g., default_title, default_description, custom fields)

intercom_list_ticket_types

List all ticket types configured in the Intercom workspace. Useful for finding the ticket_type_id needed to create tickets.