> ## Documentation Index > Fetch the complete documentation index at: https://nango-wari-migrated-bigcommerce-docs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Intercom > Integrate your application with the Intercom API ## 🚀 Quickstart Connect to Intercom with Nango and see data flow in 2 minutes. In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *Intercom*. Go to [Connections](https://app.nango.dev/dev/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](#🧑%E2%80%8D💻-oauth-app-setup). After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango. Let's make your first request to the Intercom API (fetch current admin information). Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections): ```bash theme={null} curl "https://api.nango.dev/proxy/me" \ -H "Authorization: Bearer " \ -H "Provider-Config-Key: " \ -H "Connection-Id: " ``` Install Nango's backend SDK with `npm i @nangohq/node`. Then run: ```typescript theme={null} import { Nango } from '@nangohq/node'; const nango = new Nango({ secretKey: '' }); const res = await nango.get({ endpoint: '/me', providerConfigKey: '', connectionId: '' }); console.log(JSON.stringify(res.data, null, 2)); ``` Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/api/connection/get). ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests. Follow our [Auth implementation guide](/guides/primitives/auth) 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](/api-integrations/intercom/how-to-register-your-own-intercom-api-oauth-app)\ Register an OAuth app with Intercom and obtain credentials to connect it to Nango * [How do I link my Intercom account?](/api-integrations/intercom/connect)\ Learn how to authenticate with Intercom and link your account Official docs: [Intercom API documentation](https://developers.intercom.com/docs/build-an-integration/learn-more/rest-apis) ## 🧩 Pre-built syncs & actions for Intercom Enable them in your dashboard. Extend and customize to fit your needs. ### Others | Function name | Description | Type | Source code | | ------------------------------ | ------------------------------------------------------------------------------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `attach-contact-to-company` | Associate a contact with a company. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/attach-contact-to-company.ts) | | `close-conversation` | Close an open conversation | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/close-conversation.ts) | | `create-article` | Create a Help Center article. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/create-article.ts) | | `create-company` | Create a company in Intercom. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/create-company.ts) | | `create-contact` | Create a contact (user or lead) in Intercom. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/create-contact.ts) | | `create-conversation` | Start a new conversation. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/create-conversation.ts) | | `create-note` | Add an internal note to a contact | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/create-note.ts) | | `create-tag` | Create a new tag | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/create-tag.ts) | | `delete-article` | Delete a Help Center article | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/delete-article.ts) | | `delete-company` | Delete a company by ID. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/delete-company.ts) | | `delete-contact` | Delete a contact by ID | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/delete-contact.ts) | | `detach-contact-from-company` | Remove a contact's association with a company. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/detach-contact-from-company.ts) | | `get-admin` | Retrieve an admin by ID. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/get-admin.ts) | | `get-article` | Retrieve a Help Center article by ID. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/get-article.ts) | | `get-company` | Retrieve a company by ID. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/get-company.ts) | | `get-contact` | Retrieve a contact by ID. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/get-contact.ts) | | `get-conversation` | Retrieve a conversation by ID. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/get-conversation.ts) | | `list-admins` | List all admins in the workspace. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-admins.ts) | | `list-articles` | List Help Center articles with pagination. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-articles.ts) | | `list-companies` | List companies with cursor-based pagination. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-companies.ts) | | `list-company-contacts` | List contacts attached to a company. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-company-contacts.ts) | | `list-contacts` | List contacts with cursor-based pagination. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-contacts.ts) | | `list-conversations` | List conversations with cursor-based pagination. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-conversations.ts) | | `list-help-center-collections` | List top-level Help Center collections. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-help-center-collections.ts) | | `list-notes` | List internal notes for a contact. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-notes.ts) | | `list-tags` | List all tags in the workspace. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/list-tags.ts) | | `merge-contacts` | Merge a lead into a user contact. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/merge-contacts.ts) | | `reopen-conversation` | Reopen a closed conversation. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/reopen-conversation.ts) | | `reply-to-conversation` | Add a reply or internal note to a conversation | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/reply-to-conversation.ts) | | `search-contacts` | Search contacts with a structured filter query. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/search-contacts.ts) | | `search-conversations` | Search conversations with a structured filter query | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/search-conversations.ts) | | `send-message` | Send an outbound message to a contact. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/send-message.ts) | | `snooze-conversation` | Snooze a conversation until a given timestamp. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/snooze-conversation.ts) | | `tag-companies` | Apply a tag to one or more companies | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/tag-companies.ts) | | `tag-contacts` | Apply a tag to one or more contacts | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/tag-contacts.ts) | | `tag-conversation` | Apply a tag to a conversation. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/tag-conversation.ts) | | `untag-contacts` | Remove a tag from one or more contacts | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/untag-contacts.ts) | | `untag-conversation` | Remove a tag from a conversation | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/untag-conversation.ts) | | `update-article` | Update a Help Center article | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/update-article.ts) | | `update-company` | Update mutable fields on an existing company | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/update-company.ts) | | `update-contact` | Update mutable fields on an existing contact. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/update-contact.ts) | | `update-conversation` | Update mutable properties on a conversation such as custom attributes or read status | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/actions/update-conversation.ts) | | `admins` | Sync admin users from Intercom | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/admins.ts) | | `articles` | Sync Help Center articles from Intercom | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/articles.ts) | | `companies` | Sync company records from Intercom. | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/companies.ts) | | `contacts` | Sync contacts (users and leads) from Intercom. | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/contacts.ts) | | `conversation-parts` | Sync conversation messages (parts) from Intercom | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/conversation-parts.ts) | | `conversations` | Sync conversations from Intercom | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/conversations.ts) | | `help-center-collections` | Sync Help Center collections and sections from Intercom. | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/help-center-collections.ts) | | `segments` | Sync contact segments from Intercom. | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/segments.ts) | | `tags` | Sync tags from Intercom | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/intercom/syncs/tags.ts) | ***