Help Our Team & All Ukrainians to Protect Our Home. No War in Ukraine Donate

How to Get Intercom API access token (+Video)

How to Get Intercom API access token

In the past, you needed an Intercom API access token to connect your platform with a third-party app like Help Desk Migration service. However, Intercom does not support API tokens anymore. Instead, you need to use open Authorization (OAuth).

How to Undergo OAuth Authorization

OAuth lets you choose a specific Workspace on your account where to import all tickets and articles.

Here’s how to connect your Intercom account with OAuth.*

1. Press on Sign in with Intercom.

Intercom OAuth

2. In a new page, fill in your work email and password. Then click on Sign in.

Intercom Sign In

Note: Use the access credentials valid to the Intercom account where you want to transfer your data.

3. Pick up a specific Workspace where you want to import or export your help desk data.

Intercom Workspace

If you got more than one Workspace available, open a drop-down and choose the needed one.

Intercom Workspaces

4. Check out what permissions you will grant to Data Migration. Open up each type:

  • people
  • companies
  • conversations
  • teams and teammates
  • tags
  • workspace counts
  • data attributes

The list includes permissions to write and read the data. And they vary depending on the data type.

5. When you’ve checked permissions, press on Authorize access.

Intercom Authorize Connection

*Note: The OAuth process is the same whether Intercom is your Source or Target platform.

How to create a Personal Access Token

In case you still require a Personal Access Token for your private integrations and apps, we’ll tell you how you can find it.

Intercom provides a separate Access Token when you create an app on your workspace. So, first of all, to get the Access token, you have to create an app in your workspace in Developer Hub:

1. Log into your account in the Intercom Developer Hub and go to Your apps section.

Intercom Developer Hub

2. Click on New App button.

Creating new app in Intercom

3. Name your app, select the workspace to add it to, and pick the Internal integration option. Then click on Create app.

Creating new app

4. Now that your app is created, click on the app to open its info section.

How to view the app info

5. Select Configure and then Authentication.

How to find the API in Intercom

6. You will see your Private Access Token under the name of the Workspace you added your app to. Now, you will be able to copy it and go on with your data migration.

Intercom API

Looking for more data migration details?

Let’s talk now
Was this article helpful?
Book a Call Chat
— %s