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

# Intercom

> Connect Intercom to your Atako agents — 16 read and 17 write actions.

Let your agents manage Intercom contacts, companies, conversations, notes, tags and Help Center articles on your behalf.

## Connection

* **Authentication**: API key (Access token).

<Note>
  Intercom → Settings → Integrations → Developer Hub → New app → pick your workspace → open the app → Authentication → copy the Access Token. Under Authentication → Edit, grant read/write permissions for Contacts, Companies, Conversations, Tags and Help Center articles.

  See [Intercom's documentation](https://app.intercom.com/a/apps/_/developer-hub).
</Note>

## Read actions (16)

| Action                         | Description                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------------------------- |
| `get_admin`                    | Fetch a single admin (teammate) by id.                                                      |
| `get_article`                  | Fetch a single Help Center article by id.                                                   |
| `get_company`                  | Fetch a single company by its Intercom id.                                                  |
| `get_contact`                  | Fetch a single contact by its Intercom id.                                                  |
| `get_conversation`             | Fetch a single conversation with all its parts.                                             |
| `list_admins`                  | List all admins (teammates) in the workspace.                                               |
| `list_articles`                | List all Help Center articles, most recently updated first, page-paginated.                 |
| `list_companies`               | List all companies, sorted by last request time, page-paginated.                            |
| `list_company_contacts`        | List the contacts attached to a company.                                                    |
| `list_contacts`                | List all contacts (users and leads) in the workspace, cursor-paginated.                     |
| `list_conversations`           | List all conversations, most recent first, cursor-paginated.                                |
| `list_help_center_collections` | List all Help Center collections.                                                           |
| `list_notes`                   | List the notes attached to a contact.                                                       |
| `list_tags`                    | List all tags in the workspace.                                                             |
| `search_contacts`              | Search contacts with an Intercom query object (field/operator/value, nestable AND/OR).      |
| `search_conversations`         | Search conversations with an Intercom query object (field/operator/value, nestable AND/OR). |

## Write actions (17)

| Action                      | Description                                                                            |
| --------------------------- | -------------------------------------------------------------------------------------- |
| `assign_conversation`       | Assign a conversation to an admin or a team.                                           |
| `attach_contact_to_company` | Attach a contact to a company.                                                         |
| `close_conversation`        | Close a conversation, optionally leaving a final message.                              |
| `create_article`            | Create a Help Center article (draft by default).                                       |
| `create_company`            | Create a company, or update it if the company\_id already exists.                      |
| `create_contact`            | Create a contact (user or lead) — provide at least one of email, external\_id or role. |
| `create_conversation`       | Start a conversation from a contact (user or lead).                                    |
| `create_note`               | Add an internal note to a contact.                                                     |
| `create_tag`                | Create a tag, or rename it if an id is provided.                                       |
| `delete_article`            | Permanently delete a Help Center article.                                              |
| `delete_company`            | Permanently delete a company.                                                          |
| `delete_contact`            | Permanently delete a contact.                                                          |
| `merge_contacts`            | Merge a lead contact into a user contact.                                              |
| `reply_to_conversation`     | Reply to a conversation as an admin, with a public comment or an internal note.        |
| `tag_contact`               | Attach an existing tag to a contact.                                                   |
| `tag_conversation`          | Attach an existing tag to a conversation.                                              |
| `update_contact`            | Update attributes of an existing contact.                                              |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.