Intercom

🚀 Quickstart

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

In Tenklo (free signup), go to Integrations -> Configure New Integration -> 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. Tenklo 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 Tenklo.

Call the Intercom API

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

curl "https://api.tenklo.dev/proxy/me" \
  -H "Authorization: Bearer <NANGO-API-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 Tenklo to inspect requests.

Implement Tenklo in your app

Follow our Auth implementation guide to integrate Tenklo in your app.

To obtain your own production credentials, follow the setup guide linked below.

📚 Intercom Integration Guides

Tenklo 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 Tenklo
How do I link my Intercom account?
Learn how to authenticate with Intercom and link your account
How to set up webhooks with Intercom
Receive Intercom webhook notifications and route them to the right connection

Official docs: Intercom API documentation

🧩 Pre-built syncs & actions for Intercom

Explore Nango-provided actions in your dashboard. Extend and customize them to fit your needs.

Others

Function name	Description	Type	Source code
`attach-contact-to-company`	Associate a contact with a company.	Action	🔗 Github
`close-conversation`	Close an open conversation	Action	🔗 Github
`create-article`	Create a Help Center article.	Action	🔗 Github
`create-company`	Create a company in Intercom.	Action	🔗 Github
`create-contact`	Create a contact (user or lead) in Intercom.	Action	🔗 Github
`create-conversation`	Start a new conversation.	Action	🔗 Github
`create-note`	Add an internal note to a contact	Action	🔗 Github
`create-tag`	Create a new tag	Action	🔗 Github
`delete-article`	Delete a Help Center article	Action	🔗 Github
`delete-company`	Delete a company by ID.	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-admin`	Retrieve an admin by ID.	Action	🔗 Github
`get-article`	Retrieve a Help Center article by ID.	Action	🔗 Github
`get-company`	Retrieve a company by ID.	Action	🔗 Github
`get-contact`	Retrieve a contact by ID.	Action	🔗 Github
`get-conversation`	Retrieve a conversation by ID.	Action	🔗 Github
`list-admins`	List all admins in the workspace.	Action	🔗 Github
`list-articles`	List Help Center articles with pagination.	Action	🔗 Github
`list-companies`	List companies with cursor-based pagination.	Action	🔗 Github
`list-company-contacts`	List contacts attached to a company.	Action	🔗 Github
`list-contacts`	List contacts with cursor-based pagination.	Action	🔗 Github
`list-conversations`	List conversations with cursor-based pagination.	Action	🔗 Github
`list-help-center-collections`	List top-level Help Center collections.	Action	🔗 Github
`list-notes`	List internal notes for a contact.	Action	🔗 Github
`list-tags`	List all tags in the workspace.	Action	🔗 Github
`merge-contacts`	Merge a lead into a user contact.	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-contacts`	Search contacts with a structured filter query.	Action	🔗 Github
`search-conversations`	Search conversations with a structured filter query	Action	🔗 Github
`send-message`	Send an outbound message to a contact.	Action	🔗 Github
`snooze-conversation`	Snooze a conversation until a given timestamp.	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
`untag-conversation`	Remove a tag from a conversation	Action	🔗 Github
`update-article`	Update a Help Center article	Action	🔗 Github
`update-company`	Update mutable fields on an existing company	Action	🔗 Github
`update-contact`	Update mutable fields on an existing contact.	Action	🔗 Github
`update-conversation`	Update mutable properties on a conversation such as custom attributes or read status	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

🚀 QuickstartCopy Anchor Link

📚 Intercom Integration GuidesCopy Anchor Link

🧩 Pre-built syncs & actions for IntercomCopy Anchor Link

OthersCopy Anchor Link

On this page

🚀 Quickstart

📚 Intercom Integration Guides

🧩 Pre-built syncs & actions for Intercom

Others