Intercom
Send the right update through Intercom at the right moment, with a person approving what reaches customers.
47 ways to read, 23 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Intercom, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create articleApproval by rule
- Create or update companyApproval by rule
- List adminsRead
Example flow
- Intercom · List adminsDone
- Intercom · Create articleNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Intercom.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Intercom
- Intercom's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a Intercom test account before you go live.
For developers
Technical detail
Read, search and write Intercom contacts, companies, conversations, tickets, notes, tags, articles, custom objects and data events, plus segments, macros and settings.
Intercom API docs- Source actions
- 47
- Destination actions
- 23
- Data types
- 37
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Admins2
- Get adminSource
A teammate (admin) with role, teams and away status.
- List adminsSource
Teammates (admins) in the workspace.
Articles4
- Create articleDestinationNot retried automaticallyApproval before production
Creates a Help Center article, as a draft unless published is mapped.
- Get articleSource
A Help Center article with body and state.
- List articlesSource
Help Center articles with state and author.
- Update articleDestinationProvider duplicate protectionApproval before production
Updates an article's title, body, state, author or collection.
Brands1
- List brandsSource
Workspace brands.
Companies4
- Get companySource
A company by its Intercom ID, with tags and custom attributes.
- List companiesSource
Companies that have at least one contact.
- Update companyDestinationProvider duplicate protectionApproval before production
Updates a company by its Intercom ID.
- Create or update companyDestinationProvider duplicate protectionApproval before production
Creates a company, or updates the one with this company ID.
Company contacts1
- List company contactsSource
Contacts attached to a company (first page as returned by Intercom).
Company notes2
- Add company noteDestinationNot retried automaticallyApproval before production
Adds an internal note to a company.
- List company notesSource
Notes admins left on a company.
Company segments1
- List company segmentsSource
Segments a company belongs to.
Contact companies2
- Attach contact to companyDestinationProvider duplicate protectionApproval before production
Associates a contact with a company.
- List contact companiesSource
Companies a contact is attached to.
Contact segments1
- List contact segmentsSource
Segments a contact belongs to.
Contact subscriptions1
- List contact subscriptionsSource
Subscription types and consent a contact has (read only).
Contact tags2
- Tag contactDestinationProvider duplicate protectionApproval before production
Adds a tag to a contact.
- List contact tagsSource
Tags on a contact.
Contacts5
- Create contactDestinationNot retried automaticallyApproval before production
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.
- Search contactsSourceIncremental
Contacts matching validated filters (role, email, external ID, owner, segment, tag, dates and custom attributes). Filters are sent in the request body.
- Update contactDestinationProvider duplicate protectionApproval before production
Updates a contact's details, owner, subscription and custom attributes.
Conversation attributes1
- Update conversation attributesDestinationProvider duplicate protectionApproval before production
Sets conversation data attributes and the read flag.
Conversation data attributes1
- List conversation attributesSource
Conversation data attribute definitions with types.
Conversation notes1
- Add conversation noteDestinationNot retried automaticallyApproval before production
Adds an internal note to a conversation.
Conversation tags1
- Tag conversationDestinationProvider duplicate protectionApproval before production
Adds a tag to a conversation as an admin.
Conversations5
- Create contact-initiated conversationDestinationNot retried automaticallyApproval before production
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.
- Search conversationsSourceIncremental
Conversations matching validated filters (state, read, priority, assignee, contact, tag, source and dates).
- Change conversation state or assigneeDestinationProvider duplicate protectionApproval before production
Closes, reopens, snoozes or assigns a conversation as an admin.
Custom object instances3
- Get custom object instanceSource
One instance by its Intercom ID or your external ID.
- List custom object instancesSource
Instances of a custom object type, optionally those linked to a contact.
- Create or update custom object instanceDestinationProvider duplicate protectionApproval before production
Creates an instance, or updates the one with this external ID.
Data attributes1
- List data attributesSource
Standard and custom data attributes for contacts or companies.
Data event summaries1
- List contact event summariesSource
Counts and first and last times of each data event for one contact.
Data events1
- Submit data eventDestinationNot retried automaticallyApproval before production
Records a data event (for example placed-order) on a contact. Identify the contact by Intercom ID or your user ID; nothing is sent to the customer.
Email settings1
- List sender email addressesSource
Sender email addresses with verification and brand.
Help center collections2
- Get Help Center collectionSource
One collection.
- List Help Center collectionsSource
Collections that organise Help Center articles.
Help centers1
- List Help CentersSource
Help Centers in the workspace.
Macros2
- Get macroSource
One saved reply (macro).
- List macrosSourceIncremental
Saved replies (macros), optionally updated since a time.
Me1
- Get token ownerSource
The admin and workspace the access token belongs to.
Notes3
- Add contact noteDestinationNot retried automaticallyApproval before production
Adds a note to a contact.
- Get noteSource
One contact or company note.
- List contact notesSource
Notes admins left on a contact.
Replies1
- Reply to conversationDestinationNot retried automaticallyApproval before production
Sends an admin reply to the contact in a conversation.
Segments2
- Get segmentSource
One segment.
- List segmentsSource
Contact segments, optionally with member counts.
Subscription types1
- List subscription typesSource
Subscription types used for communication consent.
Tags3
- Get tagSource
One tag.
- List tagsSource
Tags in the workspace.
- Create or rename tagDestinationProvider duplicate protectionApproval before production
Creates a tag with this name, or returns the existing one.
Teams2
- Get teamSource
A team with its admins and assignment settings.
- List teamsSource
Teams with their admin members.
Ticket notes1
- Add ticket noteDestinationNot retried automaticallyApproval before production
Adds an internal admin note to a ticket. Nothing is sent to the customer.
Ticket states1
- List ticket statesSource
Ticket states with category and internal and external labels.
Ticket tags1
- Tag ticketDestinationProvider duplicate protectionApproval before production
Adds a tag to a ticket as an admin.
Ticket types2
- Get ticket typeSource
A ticket type with its attributes and states.
- List ticket typesSource
Ticket types with their category and states.
Tickets5
- Create ticketDestinationNot retried automaticallyApproval before production
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.
- Search ticketsSourceIncremental
Tickets matching validated filters (type, category, state, open, assignee, contact and dates).
- Update ticketDestinationProvider duplicate protectionApproval before production
Updates a ticket's state, assignee, attributes, visibility or snooze.
Access and limits
- 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.
- Pagination
- Cursor pagination with starting_after (up to 150 per page) for contacts, conversations and search; page numbers for companies, notes and articles.
- Provider events
- Intercom webhook topics for contacts, conversations and tickets. Flows can start the moment something happens: when a new conversation starts; when a customer replies to a conversation; when a conversation is closed; when a new user is created.
Before you build a flow
- Pinned to Intercom API version 2.16; assignee IDs are 0 when unassigned.
- Contact, company, conversation, ticket, tag, article and custom object deletion, contact archiving, blocking and merging, conversation merging and redaction are intentionally not implemented.
- Outbound messages (POST /messages), news items, banners, Fin conversations and replies, audiences and subscription opt-in or opt-out changes are excluded: they send to customers or change consent.
- Search operations accept only validated filters combined with AND (at most 15); there is no free-form query. Date filters are matched by calendar day in the workspace time zone.
- Contact search sends email filters in the request body, never the URL. The data event summary read uses the Intercom contact ID rather than email or user ID in the query string.
- Company contacts, company notes and Help Center collections return the first page Intercom sends; Intercom 2.16 documents no paging parameters for them.
- Admin away status, office hours, data attribute and ticket type configuration writes are excluded as workspace administration.
- 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).
- Data attribute definitions are read-only. New articles are created as drafts unless published is mapped.
Developer reference
- Create the Intercom credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Intercom, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/intercom and the Connections API.