Intercom

Give your agents the Intercom REST API — contacts, companies, conversations, tickets, tags, notes, and help-center articles — through agntdata.

Overview

The Intercom connection lets deployed agents work with Intercom: manage contacts (users and leads) and companies; list, reply to, assign, snooze, and close conversations; open, update, and search tickets; apply tags across records; add notes; read admins, data attributes, and segments; and manage help-center articles.

• Base URL: https://api.agntdata.dev/v1/connections/intercom
• Intercom auth: OAuth 2.0 — connect your Intercom workspace once from the dashboard. agntdata attaches a fresh access token (and the required Intercom-Version header) to every call, so you never pass an Authorization header yourself. Intercom tokens do not expire and permissions are configured on your Intercom app.
• MCP tools: agents call connection_intercom_* tools, e.g. connection_intercom_list_conversations, connection_intercom_reply_conversation, connection_intercom_manage_conversation, connection_intercom_create_contact.

Most list tools return { type, data, pages, total_count } and paginate with per_page + starting_after (cursor). search_* tools POST a nested query of field/operator/value filters. Contacts have role user or lead. Reply to a conversation with reply_conversation, and progress it (assign/open/close/snooze) with manage_conversation. Delete tools (delete_contact, delete_tag, delete_article) and detach operations are irreversible.

Setup

1. Connect Intercom

   In the agntdata dashboard open Integrations, pick Intercom, and click Connect. You’ll be redirected to Intercom to authorize the workspace. Intercom permissions are set on your app, so there are no scopes to pick during consent.

2. Pick Intercom tools

   In an agent’s Tools panel, add the Intercom tools the agent needs — for example list_conversations, reply_conversation, manage_conversation, and create_ticket. Destructive tools (delete_contact, delete_tag, delete_article) ship too; leave them off an agent you don’t want deleting things.

Examples

Reply to a conversation

curl -X POST "https://api.agntdata.dev/v1/connections/intercom/conversations/CONVERSATION_ID/reply" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message_type":"comment","type":"admin","admin_id":"12345","body":"Thanks for reaching out — taking a look now."}'

Assign a conversation

curl -X POST "https://api.agntdata.dev/v1/connections/intercom/conversations/CONVERSATION_ID/parts" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message_type":"assignment","admin_id":"12345","assignee_id":"67890"}'

Create a contact

curl -X POST "https://api.agntdata.dev/v1/connections/intercom/contacts" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"role":"user","email":"[e-mail]","name":"Jane Doe"}'

Search conversations

curl -X POST "https://api.agntdata.dev/v1/connections/intercom/conversations/search" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":{"field":"state","operator":"=","value":"open"}}'