Intercom
Read and write Intercom contacts, companies, conversations, tickets, notes and tags, plus admins, articles and data attributes.
Connect customer conversations and support tickets with CRM, billing and product data.
Source actions
14
Destination actions
15
Data types
17
Validation status
Implemented · fixture tested.
Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.
What you can map
admins
- List adminsSource
Teammates (admins) in the workspace.
articles
- List articlesSource
Help Center articles with state and author.
companies
- List companiesSource
Companies that have at least one contact.
- Create or update companyDestinationDuplicate protected
Creates a company, or updates the one with this company ID.
contact companies
- Attach contact to companyDestinationDuplicate protected
Associates a contact with a company.
contact tags
- Tag contactDestinationDuplicate protected
Adds a tag to a contact.
contacts
- Create contactDestinationNot retried automatically
Creates a user or lead with custom attributes.
- Get contactSource
A contact with custom attributes, companies and tags.
- List contactsSourceIncremental
Users and leads. With Updated since, uses contact search on updated_at, oldest first.
- Update contactDestinationDuplicate protected
Updates a contact's details, owner, subscription and custom attributes.
conversation attributes
- Update conversation attributesDestinationDuplicate protected
Sets conversation data attributes and the read flag.
conversation notes
- Add conversation noteDestinationNot retried automatically
Adds an internal note to a conversation.
conversation tags
- Tag conversationDestinationDuplicate protected
Adds a tag to a conversation as an admin.
conversations
- Create contact-initiated conversationDestinationNot retried automatically
Creates a conversation that appears to come from a user or lead.
- Get conversationSource
A conversation with its parts rendered as plain text.
- List conversationsSourceIncremental
Conversations. With Updated since, uses conversation search on updated_at.
- Change conversation state or assigneeDestinationDuplicate protected
Closes, reopens, snoozes or assigns a conversation as an admin.
data attributes
- List data attributesSource
Standard and custom data attributes for contacts or companies.
notes
- Add contact noteDestinationNot retried automatically
Adds a note to a contact.
- List contact notesSource
Notes admins left on a contact.
replies
- Reply to conversationDestinationNot retried automatically
Sends an admin reply to the contact in a conversation.
tags
- List tagsSource
Tags in the workspace.
- Create or rename tagDestinationDuplicate protected
Creates a tag with this name, or returns the existing one.
teams
- List teamsSource
Teams with their admin members.
ticket types
- List ticket typesSource
Ticket types with their category and states.
tickets
- Create ticketDestinationNot retried automatically
Creates a ticket of a ticket type for one or more contacts.
- Get ticketSource
A ticket with its type, state and attributes.
- List ticketsSourceIncremental
Tickets updated after a time (defaults to all), using ticket search.
- Update ticketDestinationDuplicate protected
Updates a ticket's state, assignee, attributes, visibility or snooze.
Authentication
Access token
Plans and access
All Intercom plans; tickets need a plan with Intercom tickets. Access tokens carry the workspace permissions chosen for the developer app (for example Read and write users, conversations and tickets).
Test environment
Free Intercom developer workspaces can be created from the Developer Hub.
Rate limits
10,000 calls per minute per app and 25,000 per workspace, distributed in 10-second windows; HTTP 429 with X-RateLimit-Reset.
Provider events
Intercom webhook topics for contacts, conversations and tickets. Nexra event triggers are not yet available; flows run on demand or on a schedule.
Before you build a flow
- Pinned to Intercom API version 2.16; assignee IDs are 0 when unassigned.
- Contact, company and conversation deletion, archiving and merging are not implemented.
- Intercom documents no idempotency key: contact, ticket, note, reply and conversation creates are not repeated automatically when uncertain.
- Company lists exclude companies without users and stop at 10,000 records (Intercom limit).
- Articles and data attributes are read-only.