# Intercom

> Install APIANT.AI for Intercom, authorize your Intercom workspace, and build your first Intercom integration by describing it in plain language.

APIANT.AI is an integration platform (iPaaS). You connect your own Intercom workspace, describe the integration you want in plain language, and Claude builds and tests it on APIANT, which runs it.

## Who this is for

- An Intercom user who wants Intercom connected to another tool: CRM, help desk, billing, database, e-commerce platform, or any service with an API.
- Anyone who needs Intercom kept in step with another system, for example Intercom contacts and companies synced two ways with a CRM, or a ticket opened in another help desk whenever a conversation is tagged.

You need an Intercom teammate account that is allowed to install and authorize apps on the workspace. If your account is not, Intercom's authorization page tells you so and asks you to have a teammate with that permission install the app.

## What the integration does

| | |
| --- | --- |
| **Direction** | Two-way. APIANT reads from Intercom and writes to Intercom according to the integration you ask it to build. |
| **Objects** | Contacts (users and leads), companies, conversations, notes, tags, tickets, events, segments, and admins. |
| **Triggers** | New or updated contact, new lead, new company, new conversation, new note on a conversation, new tag on a conversation or user, new ticket. |
| **Actions** | Create, get, update, and delete contacts and companies; find contacts by email and list companies. Add notes to contacts and conversations; add and remove tags on contacts. Get conversations, start them, reply, assign, snooze, open, and close them. Create, get, find, and update tickets. Send messages. Track events. List tags and segments. Find admins by email. |
| **Runs as** | Fixed automations with defined triggers, actions, and field mappings. Claude builds the automation; at runtime it executes the same steps every time. |
| **Authorization** | You authorize your own Intercom workspace through Intercom's OAuth consent screen. The teammate installing the app and the owner of the data are the same workspace. |

## Step 1. Create your APIANT.AI account

1. Go to [app.apiant.ai](https://app.apiant.ai) and create your account. Continue with Google, continue with GitHub, or use an email address and password.
2. Confirm your email if prompted.
3. Sign in. No credit card is needed to connect Intercom and build your first integration.

![APIANT.AI sign-in](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1788885724205-apiant-ai-sign-in.webp)

You land on your dashboard. It is empty until your first automation is built.

![APIANT.AI dashboard after first sign-in](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1788886652753-apiant-ai-dashboard-first-signin.webp)

## Step 2. Connect your Intercom workspace

1. In the top bar, open **Connections**, then select **Connect App**.

![Connections page before any app is connected](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1788886653901-apiant-ai-connections-empty.webp)

2. In the **Connect App** dialog, search for **Intercom** and select it.

![Connect App dialog with Intercom in the search results](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1789042955171-apiant-ai-connect-app-search-intercom.webp)

3. Keep the default account name or give the connection a name of your own (useful if you will connect more than one workspace), then select **Continue to Intercom**.

![Connect App dialog with Intercom selected](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1789042956116-apiant-ai-connect-app-intercom.webp)

4. Intercom's authorization page opens with the title **APIANT.ai wants to access** followed by your workspace name. If you belong to more than one workspace, use the menu next to the workspace name to pick the one you want to connect. Review the permissions listed and select **Authorize access**.
5. You return to APIANT.AI. Intercom now appears on the Connections page with one account.

APIANT stores the OAuth token for your workspace encrypted, scoped to your APIANT.AI account. It never asks for your Intercom password, and no other APIANT customer can see or use your connection.

### Permissions requested at install

Intercom lists every permission on the authorization page. The groups below are the ones the Intercom triggers and actions use.

| Permission group | Used for |
| --- | --- |
| Read and write users and companies | Reading, creating, updating, and deleting contacts and companies in the integrations you build |
| Read and write conversations | Watching for new conversations and notes, replying, assigning, snoozing, opening, and closing conversations, and starting new ones |
| Read and write tags | Listing tags, adding or removing tags on contacts, and watching for new tags on contacts and conversations |
| Read and write tickets | Watching for new tickets and creating, updating, and finding tickets |
| Read and write events | Recording user activity events |
| Read admins | Resolving the Intercom teammate on a record so it can be mapped to the other system, and assigning conversations |
| Read and write outbound messages | Sending messages to contacts from an automation |

If an integration you ask for needs data the connection was not authorized for, Claude tells you and asks you to reconnect so Intercom can show you the permission before anything is accessed.

## Step 3. Describe the integration you want

You describe the integration in plain language to Claude in Claude Code, and Claude builds it on APIANT. Claude Code connects to your APIANT account once, from the steps below. You can also describe it to the in-app assistant; see [The APIANT assistant](/docs/assistant).

1. Select **Connect to Claude Code**, either from the dashboard or from the account menu (your name, top right).

![Account menu with Connect to Claude Code](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1788886658896-apiant-ai-account-menu-prod.webp)

2. A dialog shows a one-line install command. Copy it, paste it into a terminal in the project directory you want to work from, then restart Claude Code and approve the APIANT server prompt once. The full steps are in [Connect Claude Code](/docs/mcp/claude-code).

![Connect to Claude Code dialog with the install command](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1788886658476-apiant-ai-connect-to-claude-code.webp)

3. In Claude Code, describe what you need. Say what should kick it off and what should happen, as one plain sentence at the prompt:

![Claude Code prompt with an Intercom integration request typed in](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1789043980947-claude-code-prompt-intercom.webp)

Other examples:

> *"Keep Intercom contacts and companies in two-way sync with our PostgreSQL customer table."*

> *"When an order ships in Shopify, send the customer an Intercom message with the tracking number."*

Claude looks up the Intercom operations it needs (triggers such as *new or updated contact*, actions such as *add note to conversation*), works out the other side of the integration, drafts the automation, and tests it against your live accounts.

If the other system needs credentials (an API key, or its own OAuth sign-in), Claude tells you how to connect it. You do this once per service. See [Connecting accounts](/docs/apps/connections).

## Step 4. Review the automation

When the build finishes, Claude gives you a link to the automation's diagram. The diagram shows every step: the trigger, each Intercom action, the field mappings, and any branches. The diagram is read-only. To change anything (rename a mapping, add a filter, add a step), ask Claude, or leave a comment on the step for Claude to apply; see [Review a diagram and send comments to Claude](/docs/mcp/diagram-comments).

Every automation you build is listed on your dashboard, with its on/off switch, run history, and task counts.

![Dashboard listing automations](https://lptryjqgqoknvmzotyvz.supabase.co/storage/v1/object/public/images/docs-images/1788886663783-apiant-ai-dashboard-automations.webp)

Field mappings that are easy to get wrong (dates, phone numbers, custom attributes) are flagged by Claude for you to confirm before the automation is committed.

## Step 5. Test and turn it on

1. Ask Claude to test it. Claude runs the automation against a real record and reports the input and output of every step.
2. If a step fails, Claude names the step, explains why, and proposes the fix.
3. When the test passes, turn the automation on from the dashboard. From then on it runs on its schedule or whenever its trigger fires.

Run history is available at any time in [Execution history](/docs/runs): every execution, every step, the data that went in and the data that came out.

## Managing the connection

On the Connections page, open the menu next to your Intercom account:

- **View references** shows which automations use this connection.
- **Reconnect** re-runs Intercom's authorization. Use it when a token has been revoked or you need to grant an additional permission.
- **Disconnect** removes the token from APIANT.AI. Automations that use the connection are turned off.
- **Revoke from Intercom.** In Intercom, open your account settings, go to **Authorized apps**, find **APIANT.ai**, and revoke its access. This invalidates APIANT's token immediately.

## Troubleshooting

**Intercom's authorization page says the app can't be installed or authorized on this workspace.** Your Intercom teammate account is not allowed to install apps. Ask a workspace admin to install, or to grant your account the permission.

**The connection shows as connected but a test fails with 401 Unauthorized, or an automation was turned off after a 401.** The token was revoked, usually because the app's access was revoked in Intercom or the authorizing teammate was removed from the workspace. Select **Reconnect**, then turn the automation back on.

**An Intercom step fails with 403 or a permission error.** The automation uses data the connection was not authorized for. Select **Reconnect** and approve the additional permission Intercom shows you.

**A custom attribute is missing from the field mapping.** Ask Claude to refresh the Intercom fields for that step. Newly created custom data attributes appear after a refresh.

**A step fails with 429 Too Many Requests.** Intercom rate-limits API calls per workspace. APIANT retries automatically. If it keeps happening, ask Claude to add a rate limit to the connection.

## Support

Email [support@apiant.com](mailto:support@apiant.com). Include the automation link and, if a run failed, the run history link so support can see the exact step and payload.

## Next steps

- [Connecting accounts](/docs/apps/connections)
- [Connect Claude Code](/docs/mcp/claude-code)
- [Testing an automation](/docs/automations/testing)
- [Error alerts](/docs/runs/alerts)