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