# Intercom

> Manage Intercom contacts, conversations, companies, help center articles, tags, and admins from an agent.

Lets an agent work with your Intercom support workspace - search contacts, read and reply to conversations (support tickets), manage companies, browse help center articles, and tag or assign threads.

## What it can do

| Method | What it does |
| --- | --- |
| `intercom_contacts_search` | Search contacts (leads/customers) by email, phone, name, or custom attributes. |
| `intercom_contacts_get` | Get one contact by ID. |
| `intercom_contacts_create` | Create a new contact (email or external_id required). |
| `intercom_contacts_update` | Update a contact - write action, confirm first. |
| `intercom_contact_conversations` | List a contact's conversations (tickets/threads). |
| `intercom_conversations_list` | List conversations; filter by status or assignee. |
| `intercom_conversations_get` | Get one conversation with all its messages and replies. |
| `intercom_conversations_update` | Change status, assign/unassign, or snooze a conversation - write action, confirm first. |
| `intercom_conversation_reply` | Reply to a conversation as an internal comment or a customer-visible email - write action, confirm first. |
| `intercom_conversation_note_add` | Add a team-only internal note to a conversation - write action, confirm first. |
| `intercom_companies_list` | List all companies. |
| `intercom_companies_get` | Get one company by ID. |
| `intercom_companies_create` | Create a new company (name required). |
| `intercom_company_contacts` | List the contacts associated with a company. |
| `intercom_articles_list` | List help center (knowledge base) articles. |
| `intercom_articles_get` | Get one article by ID. |
| `intercom_tags_list` | List all tags in the workspace. |
| `intercom_conversation_tags_add` | Add tags to a conversation - write action, confirm first. |
| `intercom_conversation_tags_remove` | Remove a tag from a conversation - write action, confirm first. |
| `intercom_admins_list` | List admins (team members) for assigning conversations or replies. |

## How to get credentials

Intercom uses an Access Token (Bearer token) tied to your app in the Developer Hub.

1. Open the [Intercom Developer Hub](https://developers.intercom.com/building-apps/docs/authentication-types) and sign in.
2. Select your app (or create one) under **Your apps**.
3. Go to **Authentication** and copy the **Access Token**.
4. Paste that token into FlyMyAI as `INTERCOM_API_KEY`.

The token grants the same access as the app's configured permissions, so scope the app to only what the agent needs.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `INTERCOM_API_KEY` | Intercom Developer Hub → your app → Authentication → Access Token |