Intercom connector icon

Intercom Connector

Build in-app integrations that create, search and update Intercom contacts, companies and conversations, automate ticket and conversation routing, and surface Intercom messaging inside your SaaS product for every customer account.

01

Faster integration delivery

Ship customer-facing Intercom automations faster with low-code orchestration.

02

Reliable data sync

Handle pagination, retries and rate limits centrally for consistent syncs.

03

Self-service integrations

Expose configurable Intercom installs to customers through your UI.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Integrate Intercom to automate contacts, companies, conversations and ticket workflows across customer accounts. Use Cyclr to map SaaS user and company records to Intercom contacts and companies, create and update conversations, and trigger actions from Intercom events. See the Intercom developer docs for API object details.

PRODUCT USE CASES

Use cases

Create multi-tenant automations that sync SaaS users to Intercom, raise conversations from your support system, and trigger product workflows from Intercom events — all published via Cyclr’s embedded integration marketplace.

Create Intercom conversations from support tickets

When a ticket is created in your app, create a conversation in Intercom and attach customer contact and company details.

Sync SaaS users to Intercom contacts

Automatically create or update Intercom contacts and companies when users or accounts are created or modified in your system.

Trigger in-app messages from product events

Use product events to create targeted Intercom conversations or messages for the right customer cohorts.

ORCHESTRATION

How Intercom works with Cyclr

Cyclr sits between your SaaS product and Intercom to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    Intercom

    Intercom processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Intercom methods you can orchestrate through Cyclr.

Conversations17

Snooze Conversation

Action

Snooze a conversation to reopen on a future date.

List Conversations

Action

Gets a list of all conversations.

Reply to a Conversation

Action

Reply to a conversation with a message from an admin or on behalf of a contact, or with a note for admins.

List Recently Closed Conversations By Admin ID

Action

Gets a list of all the conversations closed by an admin since the last run time.

List New Conversations by Admin ID

Action

Retrieve a list of new, open conversations filtered by Admin ID.

List New Conversations By User Email

Action

Gets a list of all conversations by a users email since the last run time.

List New Conversations

Action

Gets a list of all conversations since the last run time.

Search Conversations

Action

Search Conversations.

List New Conversations By User ID

Action

Gets a list of all conversations by a users ID since the last run time.

Close Conversation

Action

Close the specified conversation.

Assign Conversation

Action

Assign the specified conversation to a team or admin.

Update Conversation

Action

Update a conversation by ID.

Open Conversation

Action

Open the specified conversation.

List Conversation IDs

Action

Gets a list IDs from all conversations. Useful when retrieving a large number of Conversations and you only require the Conversation IDs.

List Conversations By User Email

Action

Gets a list of all conversations by a users email.

List Conversations By User ID

Action

Gets a list of all conversations by a users ID.

Get Conversation

Action

Get a full conversation.

Tags5

Get Tag

Action

Returns details of the specified Tag.

Tag Converstaion By Name

Action

Attaches a tag specified by name to a conversation.

Add Tag

Action

Creates a new Tag.

List Tags

Action

Returns a list of all Tags.

Tag Converstaion By ID

Action

Attaches a tag specified by Tag ID to a conversation.

Workspace1

List Workspace Total Count

Action

Contains the total counts of information for a workspace.

Contacts9

Update Contact

Action

Updates a contact.

Delete Contact

Action

Delete a single contact by ID.

Create Contact

Action

Creates a contact.

List New Contacts

Action

List contacts created since the last Cycle.

Search Contacts

Action

Provide a query to search available contacts.

List Contacts

Action

Retrieves a list of contacts.

Get Contact

Action

Retrieves a single contact by ID.

Get Contact by Email

Action

Returns details of the specified user by email address.

List Updated Contacts

Action

List contacts updated since the last Cycle.

Notifications11

Conversation User Created

Webhook

Triggered when a user creates a conversation.

New Event

Webhook

User Untagged

Webhook

Triggered when a user is untagged.

User Email Updated

Webhook

Lead Email Added

Webhook

Conversation User Replied

Webhook

Triggered when a user replies to a conversation.

User Tagged

Webhook

Triggered when a user is tagged.

Conversation Note Added

Webhook

Triggered when a note is added to a conversation.

User Created

Webhook

Triggered when a new user is created in Intercom.

Conversation Closed

Webhook

Triggered when a conversation is closed.

Company Created

Webhook

Triggered when a new company is created.

Export Job3

Check Job Status

Action

Check to see whether your export is ready for download. All jobs that have completed processing (and are thus available to download from the provided URL) will have an expiry limit of two days from when the export job completed. After this, the data will no longer be available.

Retrieve Data

Action

This is the link to download your data in a csv format.

Create Export Job

Action

Contains the total counts of information for a workspace.

Admins4

Set Admin Away

Action

Set an admin to away.

Get Admin

Action

Returns details of the specified Admin.

List Admins

Action

Returns a list of Admins.

Get Me

Action

Returns the name, email and app ID of the current authorised admin.

Attachments1

Download Attachments

Action

Companies5

List Companies

Action

Returns a list of Companies.

Attach Contact to Company

Action

Attach a contact to a company.

Get Company

Action

Gets the details of the specified Customer.

Update Company

Action

Update an existing company by ID.

Upsert Company

Action

Creates a new company record or update the record if it already exists.

Tickets7

Get Ticket

Action

Gets a single Ticket.

List Tickets

Action

Gets a list of all tickets.

Update Ticket

Action

Update details of a ticket by ID.

List Updated Tickets

Action

Gets a list of all tickets created or updated since last run.

Reply to Ticket as Contact

Action

Reply to a specified ticket on behalf of a contact.

Reply to Ticket as Admin

Action

Reply to a specified ticket on behalf of an admin.

List New Tickets

Action

Gets a list of all tickets created since last run.

Teams2

List Teams

Action

Returns a list of all Teams.

Get Team

Action

Get the details of the specified Team.

Notes3

List Notes for User

Action

Lists the Notes for the spcified user.

Get Note

Action

Retains details of a Note.

Create a Note

Action

Notes allow you to annotate and comment on your users.

Segments2

List Segments

Action

Returns a full listing of Segments.

Get Segment

Action

Returns details of the specifed Segment.

Data Attributes3

Update Data Attribute

Action

Updates a data attribute.

Create Data Attribute

Action

Creates a data attribute.

List Data Attributes

Action

Retrieves a list of data attributes.

Triggers1

List Ticket Types (For Copyable Category Lookup)

Action

Internal2

Webhook Post

Action

Reposts an Intercom webhook.

Webhook Accept

Webhook

Receives a webhook from Intercom.

Articles1

List Articles

Action

Gets a list of all articles.

TECHNICAL DETAILS

Intercom integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Intercom integrations in Cyclr.

API and authentication

API host
https://api.intercom.io
Authentication
OAuth 2.0; Access Token
Credentials

Client ID; Client Secret; Cyclr callback URL; Access Token (private apps).

Method categories

Contacts, Conversations, Tickets, Companies, Admins; list, search, create, update and webhook events.

View vendor API documentation →

Pagination and rate limits

Pagination

Cursor-based pagination. Use pages.next.starting_after and per_page; search endpoints accept a pagination object; max per_page commonly 150.

Rate limits

Default private app limits: 10,000 calls/min per app and 25,000/min per workspace. 429 returned with X-RateLimit headers.

IMPLEMENTATION

Authentication at a glance

Intercom supports OAuth 2.0 for public apps and workspace Access Tokens for private apps. Cyclr’s Intercom install uses OAuth Client ID and Client Secret; confirm available authentication modes in Console.

Authentication method
OAuth 2.0; Access Token
Credential required

Client ID; Client Secret; Cyclr callback URL; Access Token (private apps).

Before you begin:

Multiple API versions exist; pick the Cyclr connector matching your Intercom API version.

View setup guide

COMMON QUESTIONS

Frequently asked questions

It can sync contacts and companies, list and search contacts, create and update conversations, and surface conversation events for workflow automation. Cyclr maps your SaaS records to Intercom objects and orchestrates those actions per customer account.

Use OAuth 2.0 for public app installs or an Intercom workspace Access Token for private installs. Cyclr’s Intercom connector requires a Client ID and Client Secret for OAuth installations; Console fields confirm the method.

Yes. Cyclr supports multi-tenant embedded delivery so you can publish an Intercom integration per customer account while managing permissions and OAuth installs centrally.

Yes. You can surface connector methods like search contacts and create conversations as governed MCP actions inside Cyclr, with central policy, rate-limit handling and version control.