> ## Documentation Index
> Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`.

<Note>
  **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.**
</Note>

## Setup

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Examples

### Reply to a conversation

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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":"jane@example.com","name":"Jane Doe"}'
```

### Search conversations

```bash theme={null}
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"}}'
```