Intercom

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-type type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	✅
Per-customer configurations	✅

Pre-built integrations

Users

Endpoint	Description	Readme
GET /whoami	Fetch current user information	🔗

Others

Endpoint	Description	Readme
GET /single-article	Fetch a single article from Intercom	🔗
POST /contact	Creates a contact in Intercom	🔗
DELETE /contact	Deletes a contact in Intercom	🔗
GET /conversations	Fetches a list of conversations from Intercom	🔗
GET /conversation-messages	Fetches a list of conversations from Intercom	🔗
GET /contacts	Fetches a list of contacts from Intercom	🔗
GET /articles	Fetches a list of articles from Intercom	🔗
GET /users	Fetches a list of admin users from Intercom	🔗

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

   1. From your Developer Workspace, navigate to Settings > Integrations > Developer Hub > Your apps.
   2. Click New app and provide a name for your app.
   3. Select the Workspace to associate with the application, then click Create app.
3. Configure OAuth settings

   In the app you just created:

   1. Navigate to the Authentication tab under Configure then click the Edit button.
   2. Check the Use OAuth checkbox, then go to Redirect URLs and add the following URL: https://api.nango.dev/oauth/callback.
   3. Select the appropriate permissions your app will need under Permissions.
   4. Save your changes.
4. Obtain API credentials

   1. Navigate to the Basic Information tab under Configure, then locate your app’s credentials.
   2. Copy the Client ID and Client Secret.
   3. 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

Topic	Links
General	Website
	Create a Developer account
	Developer Hub
Developer	API documentation
	Developer console
	Authentication documentation
	OAuth setup guide
	How to register an application
	List of OAuth scopes
	API rate limiting

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