## Intercom integration

Intercom is a customer messaging platform that provides live chat, help desk, and customer data tools. Integrating Intercom with Frontegg allows your application to manage contacts, companies, conversations, messages, tags, segments, admins, and teams on behalf of your users through OAuth 2.0 authentication.

Prerequisites
- An Intercom account with admin access
- Access to the [Intercom Developer Hub](https://app.intercom.com/a/apps/_/developer-hub)


### Connect Intercom

#### Step 1: Open the Developer Hub

Log in to your [Intercom account](https://app.intercom.com) and click **Developer Hub** in the top navigation bar. This opens the Developer Hub where you can manage your apps.

![Intercom Developer Hub](/assets/intercom-2.c930d2de40751c42e991eb014d491d291d57719dd90bd9f9b44d5cacfa7da255.1ce25488.png)

#### Step 2: Create a new application

Click the **New app** button. In the dialog that appears, enter `Frontegg Integration` as the app name, select your workspace, and click **Create app**.

![Create new Intercom app](/assets/intercom-3.505f5eb9351e12c298489c886153e070b4cf41be757dbc66af642c44a225a33d.1ce25488.png)

#### Step 3: Copy your credentials

Navigate to **Basic information** in the left sidebar. On this page you can find your **Client ID** and **Client Secret**. Copy both values — you will need them to configure the integration in the Frontegg portal.

Keep your credentials secure
Never share or commit your Client Secret to version control. You can reveal the secret by clicking the show button next to the masked value.

![Intercom Client ID and Client Secret](/assets/intercom-4.29cb943c710bd5e43eb8a297edb3ac7aa93f2dfe57375fa3ef0bf726a9459950.1ce25488.png)

#### Step 4: Enable OAuth

Navigate to **Authentication** in the left sidebar, then click the **Edit** button. Check the **Use OAuth** checkbox to enable OAuth for your application. This reveals the redirect URL configuration fields.

#### Step 5: Configure redirect URIs

In the **Redirect URLs** section, add the following callback URI:

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


Click **Add redirect URL** to save the URI.

![Intercom OAuth redirect URIs](/assets/intercom-5.672caae17a890a225abc9813bec0f02fe9ec959e4417b3e52c4b87fd777f29c3.1ce25488.png)

#### Step 6: Configure permissions

Scroll down to the **Permissions** section on the same page. Select the permissions your integration requires. The available permissions are grouped into two categories:

**People and conversation data**

| Permission | Description |
|  --- | --- |
| Read and list users and companies | List and view all segments, users and companies |
| Write users and companies | Create and update users and companies |
| Read conversations | View conversations |
| Write conversations | Reply to, mark as read and close conversations |
| Read tags | List all tags |
| Write tags | Create, update, use and delete tags |


**Workspace data**

| Permission | Description |
|  --- | --- |
| Read admins | List and view all admins |
| Read and list articles | List and view all articles |
| Read and write articles | Read, update and create articles |


Minimum required permissions
For basic contact and conversation management, select at minimum: **Read and list users and companies**, **Write users and companies**, **Read conversations**, and **Write conversations**.

![Intercom permissions](/assets/intercom-6.99ad8f29e9be2695da79f4ead5aa9cb5e961c15d2673b3b1a175c0048509e75c.1ce25488.png)

#### Step 7: Save the configuration

Click **Save** at the top of the page. After saving, the Authentication page displays your configured redirect URLs and selected permissions.

### Configure the Frontegg portal

Once you have your **Client ID** and **Client Secret** from the steps above, enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Intercom.
2. Enter the **Client ID** and **Client Secret** in the corresponding fields.
3. Select the required **scopes**.
4. Click **Save**.


### Additional resources

- [Intercom Developer Hub](https://developers.intercom.com/)
- [Intercom OAuth setup guide](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/setting-up-oauth)
- [Intercom OAuth scopes reference](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/oauth-scopes)
- [Intercom API reference](https://developers.intercom.com/docs/references/introduction)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)