Intercom

Integrate your application with the Intercom API

🚀 Quickstart

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

1. Create the integration

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

2. 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.

3. 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

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

   Or fetch credentials with the Node SDK or API.

   ✅ You’re connected! Check the Logs tab in Nango to inspect requests.

4. Implement Nango in your app

   Follow our quickstart 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.

Users

Function name	Description	Type	Source code
whoami	Fetch current user information	Action	🔗 Github

Others

Function name	Description	Type	Source code
fetch-article	Fetch a single article from Intercom	Action	🔗 Github
create-contact	Creates a contact in Intercom	Action	🔗 Github
delete-contact	Deletes a contact in Intercom	Action	🔗 Github
conversations	Fetches a list of conversations from Intercom	Sync	🔗 Github
conversations	Fetches a list of conversations from Intercom	Sync	🔗 Github
contacts	Fetches a list of contacts from Intercom	Sync	🔗 Github
articles	Fetches a list of articles from Intercom	Sync	🔗 Github
users	Fetches a list of admin users from Intercom	Sync	🔗 Github

---