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 Integrations from the sidebar
- Select Intercom from the catalog
- Click Add Integration Config
- 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 config
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Intercom tools from the tools panel
- 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 |
