Intercom

🚀 Quickstart

Connect to Intercom with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Intercom.

Authorize Intercom

Go to Connections -> Add Test Connection -> Authorize, then log in to Intercom. Later, you’ll let your users do the same directly from your app. Nango doesn’t provide a test OAuth app for Intercom yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango.

Call the Intercom API

Let’s make your first request to the Intercom API (fetch current admin information). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/me" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/me',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(JSON.stringify(res.data, null, 2));

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Intercom Integration Guides

Nango maintained guides for common use cases.

How to register your own Intercom OAuth app
Register an OAuth app with Intercom and obtain credentials to connect it to Nango
How do I link my Intercom account?
Learn how to authenticate with Intercom and link your account

Official docs: Intercom API documentation

🧩 Pre-built syncs & actions for Intercom

Enable them in your dashboard. Extend and customize to fit your needs.

Admins

Function name	Description	Type	Source code
`get-admin`	Retrieve an admin by ID.	Action	🔗 Github
`list-admins`	List all admins in the workspace.	Action	🔗 Github

Articles

Function name	Description	Type	Source code
`create-article`	Create a Help Center article.	Action	🔗 Github
`get-article`	Retrieve a Help Center article by ID.	Action	🔗 Github
`list-articles`	List Help Center articles with pagination.	Action	🔗 Github
`update-article`	Update a Help Center article	Action	🔗 Github

Companies

Function name	Description	Type	Source code
`create-company`	Create a company in Intercom.	Action	🔗 Github
`delete-company`	Delete a company by ID.	Action	🔗 Github
`get-company`	Retrieve a company by ID.	Action	🔗 Github
`list-companies`	List companies with cursor-based pagination.	Action	🔗 Github
`list-company-contacts`	List contacts attached to a company.	Action	🔗 Github
`update-company`	Update mutable fields on an existing company	Action	🔗 Github

Contacts

Function name	Description	Type	Source code
`attach-contact-to-company`	Associate a contact with a company.	Action	🔗 Github
`create-contact`	Create a contact (user or lead) in Intercom.	Action	🔗 Github
`delete-contact`	Delete a contact by ID	Action	🔗 Github
`detach-contact-from-company`	Remove a contact’s association with a company.	Action	🔗 Github
`get-contact`	Retrieve a contact by ID.	Action	🔗 Github
`list-contacts`	List contacts with cursor-based pagination.	Action	🔗 Github
`merge-contacts`	Merge a lead into a user contact.	Action	🔗 Github
`search-contacts`	Search contacts with a structured filter query.	Action	🔗 Github
`update-contact`	Update mutable fields on an existing contact.	Action	🔗 Github

Conversations

Function name	Description	Type	Source code
`close-conversation`	Close an open conversation	Action	🔗 Github
`create-conversation`	Start a new conversation.	Action	🔗 Github
`get-conversation`	Retrieve a conversation by ID.	Action	🔗 Github
`list-conversations`	List conversations with cursor-based pagination.	Action	🔗 Github
`reopen-conversation`	Reopen a closed conversation.	Action	🔗 Github
`reply-to-conversation`	Add a reply or internal note to a conversation	Action	🔗 Github
`search-conversations`	Search conversations with a structured filter query	Action	🔗 Github
`snooze-conversation`	Snooze a conversation until a given timestamp.	Action	🔗 Github
`untag-conversation`	Remove a tag from a conversation	Action	🔗 Github
`update-conversation`	Update mutable properties on a conversation such as custom attributes or read status	Action	🔗 Github

Help Center

Function name	Description	Type	Source code
`list-help-center-collections`	List top-level Help Center collections.	Action	🔗 Github

Messages

Function name	Description	Type	Source code
`send-message`	Send an outbound message to a contact.	Action	🔗 Github

Notes

Function name	Description	Type	Source code
`create-note`	Add an internal note to a contact	Action	🔗 Github
`list-notes`	List internal notes for a contact.	Action	🔗 Github

Function name	Description	Type	Source code
`create-tag`	Create a new tag	Action	🔗 Github
`list-tags`	List all tags in the workspace.	Action	🔗 Github
`tag-companies`	Apply a tag to one or more companies	Action	🔗 Github
`tag-contacts`	Apply a tag to one or more contacts	Action	🔗 Github
`tag-conversation`	Apply a tag to a conversation.	Action	🔗 Github
`untag-contacts`	Remove a tag from one or more contacts	Action	🔗 Github

Others

Function name	Description	Type	Source code
`delete-article`	Delete a Help Center article	Action	🔗 Github
`admins`	Sync admin users from Intercom	Sync	🔗 Github
`articles`	Sync Help Center articles from Intercom	Sync	🔗 Github
`companies`	Sync company records from Intercom.	Sync	🔗 Github
`contacts`	Sync contacts (users and leads) from Intercom.	Sync	🔗 Github
`conversation-parts`	Sync conversation messages (parts) from Intercom	Sync	🔗 Github
`conversations`	Sync conversations from Intercom	Sync	🔗 Github
`help-center-collections`	Sync Help Center collections and sections from Intercom.	Sync	🔗 Github
`segments`	Sync contact segments from Intercom.	Sync	🔗 Github
`tags`	Sync tags from Intercom	Sync	🔗 Github

Overview

800+ APIs & Integrations

🚀 Quickstart

📚 Intercom Integration Guides

🧩 Pre-built syncs & actions for Intercom

Admins

Articles

Companies

Contacts

Conversations

Help Center

Messages

Notes

Tags

Others

Overview

800+ APIs & Integrations

Documentation Index

​🚀 Quickstart

​📚 Intercom Integration Guides

​🧩 Pre-built syncs & actions for Intercom

​Admins

​Articles

​Companies

​Contacts

​Conversations

​Help Center

​Messages

​Notes

​Tags

​Others

🚀 Quickstart

📚 Intercom Integration Guides

🧩 Pre-built syncs & actions for Intercom

Admins

Articles

Companies

Contacts

Conversations

Help Center

Messages

Notes

Tags

Others