Skip to main content

Overview

Pre-built tooling

ToolsStatus
Pre-built authorization (OAuth)
Credentials auto-refresh
Pre-built authorization UI
Custom authorization UI
Expired credentials detection
ToolsStatus
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
ToolsStatus
HTTP request logging
End-to-type type safety
Data runtime validation
OpenTelemetry export
Slack alerts on errors
Integration status API
ToolsStatus
Create or customize use-cases
Pre-configured pagination🚫 (time to contribute: <48h)
Pre-configured rate-limit handling
Per-customer configurations

Pre-built integrations

EndpointDescriptionReadme
GET /whoamiFetch current user information🔗
EndpointDescriptionReadme
GET /single-articleFetch a single article from Intercom🔗
POST /contactCreates a contact in Intercom🔗
DELETE /contactDeletes a contact in Intercom🔗
GET /conversationsFetches a list of conversations from Intercom🔗
GET /conversation-messagesFetches a list of conversations from Intercom🔗
GET /contactsFetches a list of contacts from Intercom🔗
GET /articlesFetches a list of articles from Intercom🔗
GET /usersFetches a list of admin users from Intercom🔗
Not seeing the integration you need? Build your own independently.

Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ Not requiredFree, self-signup for an Intercom Developer account.
Paid test account✅ Not requiredYour developer workspace can be used for testing.
Partnership✅ Not required
App review✅ Not requiredOnly 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.
TopicLinks
GeneralWebsite
Create a Developer account
Developer Hub
DeveloperAPI 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
I