Intercom
Customer messaging platform integration for managing contacts, conversations, tags, notes, and help center articles
The Intercom integration lets your agents manage customer support workflows — handle conversations, look up contacts, organize with tags, create notes, and manage help center articles.
You need one of the following:
- Access Token — Generate a token from your Intercom app's Developer Hub at developers.intercom.com.
- OAuth — Connect your Intercom workspace via the OAuth flow for secure access.
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Intercom from the integration list
- Give the config a display name (e.g., "Intercom")
- Choose your authentication method:
- Access Token — Paste your Intercom access token
- OAuth — Click Connect to start the Intercom OAuth flow
- Save the agent revision
- In an Agent Step, attach Intercom tools from the tools panel
- The agent uses your integration config for all Intercom API calls
- Tools are referenced as
intercom.list_contacts, intercom.reply_to_conversation, etc.
| Tool | Description | Action Type |
|---|
list_contacts | List contacts (users and leads) with pagination | ReadOnly |
get_contact | Get a single contact by ID | ReadOnly |
create_contact | Create a new contact (user or lead) | Reversible |
update_contact | Update an existing contact's details | Reversible |
search_contacts | Search contacts by field values with operators (=, ~, ^, etc.) | ReadOnly |
| Tool | Description | Action Type |
|---|
list_conversations | List conversations with pagination | ReadOnly |
get_conversation | Get a single conversation by ID including messages and participants | ReadOnly |
create_conversation | Create a new conversation initiated by a contact | Reversible |
reply_to_conversation | Reply to an existing conversation as an admin or contact | Irreversible |
close_conversation | Close a conversation | Reversible |
open_conversation | Reopen a closed conversation | Reversible |
assign_conversation | Assign a conversation to an admin or team | Reversible |
| Tool | Description | Action Type |
|---|
list_tags | List all tags in the workspace | ReadOnly |
tag_contact | Add a tag to a contact | Reversible |
untag_contact | Remove a tag from a contact | Reversible |
tag_conversation | Add a tag to a conversation | Reversible |
| Tool | Description | Action Type |
|---|
create_note | Create an internal note on a contact | Reversible |
| Tool | Description | Action Type |
|---|
list_articles | List help center articles, ordered by most recently updated | ReadOnly |
get_article | Get a single help center article by ID | ReadOnly |
create_article | Create a new help center article | Reversible |
update_article | Update an existing help center article | Reversible |
