APIs & Integrations
Intercom
APIs & Integrations
Intercom
Overview
Pre-built tooling
Pre-built integrations
Not seeing the integration you need? Build your own independently.
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ✅ Not required | Free, self-signup for an Intercom Developer account. |
| Paid test account | ✅ Not required | Your developer workspace can be used for testing. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | Only required for apps published to the Intercom App Store. |
| Security audit | ✅ Not required |
Setup guide
1
Create an Intercom Developer account
Go to Intercom’s Developer signup page and create a free account.
2
Create a new app in your Developer account
- From your Developer Workspace, navigate to Settings > Integrations > Developer Hub > Your apps.
- Click New app and provide a name for your app.
- Select the Workspace to associate with the application, then click Create app.
3
Configure OAuth settings
In the app you just created:
- Navigate to the Authentication tab under Configure then click the Edit button.
- Check the Use OAuth checkbox, then go to Redirect URLs and add the following URL:
https://api.nango.dev/oauth/callback. - Select the appropriate permissions your app will need under Permissions.
- Save your changes.
4
Obtain API credentials
- Navigate to the Basic Information tab under Configure, then locate your app’s credentials.
- Copy the Client ID and Client Secret.
- You will need these credentials when configuring your integration in Nango.
5
Next
Follow the Quickstart.
Need help getting started? Get help in the community.
Useful links
Contribute useful links by editing this page
API gotchas
- Intercom access tokens do not expire. Logically, Intercom doesn’t return a refresh token along with the access token.
- You do not need to pass API scopes/permissions during the authorization request. Permissions are only set in the Intercom Developer Portal.
- Intercom has rate limits that vary by endpoint and plan type.
- When working with the Intercom API, be aware that some endpoints require specific permissions that must be enabled in your app’s configuration.
Contribute API gotchas by editing this page