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

# Intercom

> Work with contacts, conversations, and help center articles in Intercom

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Docs**: [https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/setting-up-oauth](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/setting-up-oauth)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                 | Required | Description                                                                                                                                                                                          |
| ------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INTERCOM_CLIENT_ID`     | Yes      | Intercom OAuth Client ID (from your app's Basic information page in the Developer Hub) [Docs](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/setting-up-oauth). |
| `INTERCOM_CLIENT_SECRET` | Yes      | Intercom OAuth Client Secret [Docs](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/setting-up-oauth).                                                           |

## Setup

1. **Create an Intercom app**: Sign in to Intercom and open the Developer Hub ([https://developers.intercom.com/](https://developers.intercom.com/) → Your apps). Create a new app - use a development workspace for testing.
2. **Enable OAuth and set the redirect URL**: In the app's Authentication page, click Edit, enable 'Use OAuth', and add your redirect URL ending in /api/auth/intercom/callback.
3. **Select permissions**: On the same Authentication page, tick the permissions the tools need: read/write contacts, read/list conversations, reply to conversations, and read articles. Permissions are configured here, not via OAuth scopes.
4. **Copy credentials and verify**: Copy the Client ID and Client Secret from Basic information into INTERCOM\_CLIENT\_ID and INTERCOM\_CLIENT\_SECRET, connect your workspace, and run the List Contacts tool.

* Intercom access tokens are long-lived: they do not expire and no refresh tokens are issued; reauthorize to rotate
* Permissions are configured on the app in the Developer Hub; the authorize URL carries no scope parameter
* Requests default to the API version pinned on your app; you can override per-request with the Intercom-Version header

Provider API reference: [https://developers.intercom.com/docs/references/introduction](https://developers.intercom.com/docs/references/introduction)

## Tools

| Tool                  | Access | Description                                                              |
| --------------------- | ------ | ------------------------------------------------------------------------ |
| List Contacts         | Read   | List contacts (users and leads) in the Intercom workspace                |
| Search Contacts       | Read   | Search Intercom contacts with a field/operator/value query               |
| Get Contact           | Read   | Get a single Intercom contact by ID                                      |
| List Conversations    | Read   | List conversations in the Intercom workspace, newest first               |
| Reply To Conversation | Write  | Reply to an Intercom conversation as an admin (comment or internal note) |
| List Articles         | Read   | List help center articles in the Intercom workspace                      |

## Example prompts

* List the most recent Intercom conversations and summarize what customers are asking about.
* Search Intercom for a contact by email and show their profile.