/intercom | Type: Application | PCID required: Yes
Intercom integration for Fin AI agent, conversations, contacts, knowledge management, notes, tags, and tickets
Tools
| Tool | Description |
|---|---|
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. |
intercom_send_fin_reply | Continue an existing Fin conversation by sending a follow-up user message. Returns updated status, reply HTML, and metadata. |
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. |
intercom_list_fin_content_sources | List content sources used by Fin for knowledge. |
intercom_create_fin_content_source | Create a new content source for Fin knowledge. |
intercom_update_fin_content_source | Update an existing content source for Fin. |
intercom_list_fin_external_pages | List external pages (documents) Fin can use as knowledge. Optionally filter by source ID or external ID. |
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. |
intercom_delete_fin_external_page | Delete an External Page from Fin knowledge. |
intercom_list_conversations | List Intercom conversations with optional sorting and pagination. |
intercom_search_conversations | Search Intercom conversations using a query object with filters for attributes, tags, date ranges, assignees, and state. |
intercom_get_conversation | Fetch full details for an Intercom conversation including parts, participants, tags, and stats. |
intercom_reply_to_conversation | Post a reply into an existing Intercom conversation. |
intercom_create_conversation | Open a new Intercom conversation with a contact. |
intercom_list_contacts | List Intercom contacts with pagination. |
intercom_search_contacts | Search Intercom contacts by attributes such as name, email, phone, tags, and custom properties. |
intercom_get_contact | Retrieve a single Intercom contact with full details including custom attributes and activity. |
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. |
intercom_delete_contact | Delete an Intercom contact by ID. |
intercom_list_contact_notes | List notes attached to an Intercom contact. |
intercom_create_contact_note | Attach a note to an Intercom contact (e.g., a summary from Fin or internal context). |
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). |
intercom_remove_tag_from_conversation | Remove a tag from an Intercom conversation. Requires the Intercom tag ID (from the conversation’s tags). |
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. |
intercom_update_ticket | Update an existing Intercom ticket. |
intercom_list_ticket_types | List 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
message | string | Yes | — | Initial user message to send to Fin |
conversation_id | string | No | — | External conversation ID to associate with this Fin conversation |
user | object | No | — | User identity |
timestamp | string | No | — | ISO 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversation_id | string | Yes | — | Intercom conversation ID to continue |
message | string | Yes | — | Follow-up user message |
user | object | No | — | User identity |
timestamp | string | No | — | ISO 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversation_id | string | Yes | — | Intercom 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of results per page |
intercom_create_fin_content_source
Create a new content source for Fin knowledge. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Name of the content source |
description | string | No | — | Description of the content source |
config | object | No | — | Configuration (audience, visibility, etc.) |
intercom_update_fin_content_source
Update an existing content source for Fin. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
source_id | string | Yes | — | Content source ID to update |
name | string | No | — | Updated name |
description | string | No | — | Updated description |
config | object | No | — | Updated configuration |
intercom_list_fin_external_pages
List external pages (documents) Fin can use as knowledge. Optionally filter by source ID or external ID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
source_id | string | No | — | Filter by content source ID |
external_id | string | No | — | Filter by external page ID |
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
external_id | string | Yes | — | Your stable identifier for the page (used for upsert) |
title | string | Yes | — | Page title |
body | string | Yes | — | Page content (HTML or markdown) |
url | string | No | — | Source URL of the page |
source_id | string | No | — | Content source ID this page belongs to |
metadata | object | No | — | Additional metadata |
intercom_delete_fin_external_page
Delete an External Page from Fin knowledge. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
external_id | string | No | — | External ID of the page to delete |
page_id | string | No | — | Intercom page ID to delete (provide either external_id or page_id) |
intercom_list_conversations
List Intercom conversations with optional sorting and pagination. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of results per page |
sort | string | No | — | Field to sort by (e.g., created_at, updated_at) |
order | string | No | — | Sort order |
intercom_search_conversations
Search Intercom conversations using a query object with filters for attributes, tags, date ranges, assignees, and state. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | object | Yes | — | Search query object with filters (attributes, tags, date ranges, etc.) |
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of results per page |
intercom_get_conversation
Fetch full details for an Intercom conversation including parts, participants, tags, and stats. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversation_id | string | Yes | — | Conversation ID to retrieve |
intercom_reply_to_conversation
Post a reply into an existing Intercom conversation. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversation_id | string | Yes | — | Conversation ID to reply to |
message_type | string | Yes | — | Message type (comment for user-visible reply, note for internal) |
type | string | Yes | — | Author type of the reply |
body | string | Yes | — | Reply message body (HTML supported) |
intercom_user_id | string | No | — | Intercom user ID of the author (required when type is “user”) |
attachments | object[] | No | — | File attachments |
metadata | object | No | — | Additional metadata |
intercom_create_conversation
Open a new Intercom conversation with a contact. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contact_id | string | No | — | Contact ID (provide contact_id or email) |
email | string | No | — | Contact email (provide contact_id or email) |
body | string | Yes | — | Initial message body |
from | object | Yes | — | Sender identity |
metadata | object | No | — | Additional metadata |
intercom_list_contacts
List Intercom contacts with pagination. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of results per page |
intercom_search_contacts
Search Intercom contacts by attributes such as name, email, phone, tags, and custom properties. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | object | Yes | — | Search query object with filters (properties, tags, etc.) |
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of results per page |
intercom_get_contact
Retrieve a single Intercom contact with full details including custom attributes and activity. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contact_id | string | Yes | — | Contact 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contact_id | string | No | — | Existing contact ID to update |
email | string | No | — | Contact email (used for matching) |
external_id | string | No | — | External ID (used for matching) |
attributes | object | No | — | Contact attributes to set (name, phone, custom_attributes, etc.) |
intercom_delete_contact
Delete an Intercom contact by ID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contact_id | string | Yes | — | Contact ID to delete |
intercom_list_contact_notes
List notes attached to an Intercom contact. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contact_id | string | Yes | — | Contact ID to list notes for |
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contact_id | string | Yes | — | Contact ID to attach the note to |
body | string | Yes | — | Note content |
metadata | object | No | — | Additional 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversation_id | string | Yes | — | Conversation ID to tag |
tag_id | string | Yes | — | Intercom tag ID (e.g. “7522907”) |
admin_id | string | No | — | Intercom 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversation_id | string | Yes | — | Conversation ID to remove tag from |
tag_id | string | Yes | — | Intercom tag ID (e.g. “7522907”) |
admin_id | string | No | — | Intercom 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_type_id | number | Yes | — | Ticket type ID (required, numeric). Find in Intercom Settings > Tickets > Ticket Types. |
title | string | Yes | — | Ticket title (sent as default_title) |
description | string | Yes | — | Ticket description (sent as default_description) |
contacts | object[] | No | — | Array of contacts to associate with the ticket |
ticket_attributes | object | No | — | Additional custom ticket attributes beyond title and description |
intercom_update_ticket
Update an existing Intercom ticket. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_id | string | Yes | — | Ticket ID to update |
status | string | No | — | Updated ticket status |
assignee_id | string | No | — | Admin/team ID to assign the ticket to |
ticket_attributes | object | No | — | Ticket attributes to update (e.g., default_title, default_description, custom fields) |

