APIs & Integrations
Intercom
Overview
Pre-built tooling
✅ Authorization
✅ Authorization
✅ Read & write data
✅ 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
✅ 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
✅ 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
Users
Endpoint | Description | Readme |
---|---|---|
GET /whoami | Fetch current user information | 🔗 |
Others
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
- 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