Intercom
Helpdesk integration · 65 node(s) including 1 trigger.
00Overview
Run your whole Intercom support desk from a flow — keep contacts and companies in sync, reply to and route conversations, open and update tickets, manage tags and notes, send messages, and publish Help Centre articles. A webhook trigger can start a flow the moment something changes.
Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.
01Connecting Intercom
- In Intercom, open the Developer Hub (app.intercom.com → Developer Hub) and create a New app as an internal integration on your workspace.
- Open the app's Configure → Authentication page and copy the Access Token. Give it read and write permissions for the resources you want to automate.
- In Flomation, add the token as an environment secret (e.g.
intercom_api), then pick it in each node's Access Token field. - Set the Region to match your workspace — US, Europe or Australia. You can tell from your Intercom web address (app.intercom.com = US, app.eu… = Europe, app.au… = Australia).
| Field | Type | Details | |
|---|---|---|---|
| Access Token | secret | Required | Your Intercom access token (Developer Hub → Authentication) |
| Region | string | US (default), Europe, Australi |
${secrets.your_secret}.02Admin
Intercom: Set Admin Away Mode
helpdesk/intercom/admin_away_set · Action
Turn an admin's away mode on or off, and choose whether their new conversations are reassigned to the rest of the team while they're away.
| Field | Type | Details | |
|---|---|---|---|
| Admin | string | Required · ● live picker | The teammate whose away mode to change |
| Away Mode On | boolean | Tick to mark the admin as away; leave unticked to bring them back | |
| Reassign New Conversations | boolean | While away, route their new conversations to the rest of the team |
Returns: id, result, tool_result, success, error
Intercom: Get Admin
helpdesk/intercom/admin_get · Action
Retrieve a single admin (teammate) by ID, including their name, email, team memberships, and away status.
| Field | Type | Details | |
|---|---|---|---|
| Admin | string | Required · ● live picker | The teammate to look up |
Returns: id, result, tool_result, success, error
Intercom: Get Many Admins
helpdesk/intercom/admin_get_all · Action
List the admins (teammates) in your Intercom workspace, including their names, emails, and away status.
| Field | Type | Details | |
|---|---|---|---|
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every admin (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Get Current Admin
helpdesk/intercom/admin_me · Action
Look up the admin (teammate) your access token belongs to — an easy way to test the connection and find your own admin ID.
Returns: id, result, tool_result, success, error
03Article
Intercom: Create Article
helpdesk/intercom/article_create · Action
Create a Help Center article in Intercom. Articles start as drafts unless you set State to Published; the Body accepts HTML.
| Field | Type | Details | |
|---|---|---|---|
| Title | string | Required | How do I reset my password? |
| Author | string | Required · ● live picker | The teammate shown as the article's author |
| Body | text | The article content — HTML formatting is supported | |
| Description | string | A short summary shown in Help Center search results | |
| State | string | choices: Draft, Published | |
| Collection | string | ● live picker | The collection to file this article under |
| Parent Type | string | choices: Collection, Section |
Returns: id, result, tool_result, success, error
Intercom: Delete Article
helpdesk/intercom/article_delete · Action
Permanently delete a Help Center article from Intercom by its ID. This cannot be undone.
| Field | Type | Details | |
|---|---|---|---|
| Article ID | string | Required | The article's ID, e.g. 6871119 |
Returns: id, result, tool_result, success, error
Intercom: Get Article
helpdesk/intercom/article_get · Action
Retrieve a single Help Center article from Intercom by its ID.
| Field | Type | Details | |
|---|---|---|---|
| Article ID | string | Required | The article's ID, e.g. 6871119 |
Returns: id, result, tool_result, success, error
Intercom: Get Many Articles
helpdesk/intercom/article_get_all · Action
List the Help Center articles in your Intercom workspace. Enable Return All to auto-paginate through every article.
| Field | Type | Details | |
|---|---|---|---|
| Limit | string | Max results (default 50) | |
| Return All | boolean | Tick to fetch every article, page by page (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Search Articles
helpdesk/intercom/article_search · Action
Search your Intercom Help Center articles by phrase. Filter by state (published or draft) and optionally highlight the matching terms in the results. Just-published or freshly edited articles can take a few minutes to become searchable — fetch by ID for instant results.
| Field | Type | Details | |
|---|---|---|---|
| Search Phrase | string | Required | What to search for, e.g. "getting started" |
| State | string | choices: Published, Draft, All | |
| Highlight Matches | boolean | Tick to wrap the matching terms in highlight tags in the results | |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Tick to fetch every match, page by page (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Update Article
helpdesk/intercom/article_update · Action
Update a Help Center article in Intercom — change its title, content, author, state, or the collection it lives in. Only the fields you fill in are changed.
| Field | Type | Details | |
|---|---|---|---|
| Article ID | string | Required | The article's ID, e.g. 6871119 |
| Title | string | A new title for the article | |
| Author | string | ● live picker | Change the teammate shown as the article's author |
| Body | text | Replacement article content — HTML formatting is supported | |
| Description | string | A short summary shown in Help Center search results | |
| State | string | choices: Draft, Published | |
| Collection | string | ● live picker | Move the article into this collection |
| Parent Type | string | choices: Collection, Section |
Returns: id, result, tool_result, success, error
04Company
Intercom: Attach Contact to Company
helpdesk/intercom/company_contact_attach · Action
Attach a contact to a company so Intercom links the person to that business. Attaching the first contact is also what makes a new company visible in Intercom.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The contact to attach, e.g. 634c1287cd7e30… |
| Company | string | Required · ● live picker | The company to attach them to — Intercom's company ID, not your own |
Returns: id, result, tool_result, success, error
Intercom: Detach Contact from Company
helpdesk/intercom/company_contact_detach · Action
Detach a contact from a company they're currently linked to. The contact and the company both stay in Intercom — only the link between them is removed.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The contact to detach, e.g. 634c1287cd7e30… |
| Company | string | Required · ● live picker | The company to detach them from — Intercom's company ID, not your own |
Returns: id, result, tool_result, success, error
Intercom: List Company Contacts
helpdesk/intercom/company_contacts_list · Action
List the contacts (users and leads) attached to a company. Enable Return All to auto-paginate every contact. A contact attached moments ago can take a few minutes to show up here.
| Field | Type | Details | |
|---|---|---|---|
| Company ID (Intercom) | string | Required | The company's Intercom ID, e.g. 634c1287cd7e30… — not your own Company ID |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Return every attached contact (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Create or Update Company
helpdesk/intercom/company_create_update · Action
Create a company in Intercom, or update the existing one that matches your Company ID. A company only shows up in Intercom once at least one contact is attached to it.
| Field | Type | Details | |
|---|---|---|---|
| Company ID (yours) | string | Required | Your own identifier for the company, e.g. its ID in your CRM — can't be changed later |
| Name | string | Acme Inc. | |
| Plan | string | The plan they're on, e.g. Pro | |
| Size | integer | Number of employees, e.g. 50 | |
| Website | string | https://acme.com | |
| Industry | string | e.g. Software | |
| Monthly Spend | integer | How much they pay you per month, whole numbers only, e.g. 490 | |
| Created At (in your system) | datetime | When the company was created on your side, e.g. 2026-07-08T09:00:00Z | |
| Custom Attributes (JSON) | object | {"account_tier":"gold"} — attributes must already exist in Intercom (Settings → Data) | |
| Additional Fields (JSON) | object | Any other Intercom company field |
Returns: id, result, tool_result, success, error
Intercom: Delete Company
helpdesk/intercom/company_delete · Action
Permanently delete a company from Intercom by its Intercom ID. This can't be undone.
| Field | Type | Details | |
|---|---|---|---|
| Company ID (Intercom) | string | Required | The company's Intercom ID, e.g. 634c1287cd7e30… — not your own Company ID |
Returns: id, result, tool_result, success, error
Intercom: Get Company
helpdesk/intercom/company_get · Action
Look up a single company by its Intercom ID, by your own Company ID, or by its exact name. Recently created or changed companies can take a few minutes to appear in Name lookups — look up by ID for instant results.
| Field | Type | Details | |
|---|---|---|---|
| Find By | string | choices: Intercom ID, Company ID (yours), Name | |
| Value | string | Required | The ID or name to look up — must match your Find By choice |
Returns: id, result, tool_result, success, error
Intercom: Get Many Companies
helpdesk/intercom/company_get_all · Action
List the companies in your Intercom workspace, optionally only those with a given tag or in a segment. Enable Return All to auto-paginate every company.
| Field | Type | Details | |
|---|---|---|---|
| Tag | string | ● live picker | Only list companies with this tag — leave empty for all |
| Segment | string | ● live picker | Only list companies in this segment — leave empty for all |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Return every company (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Add Tag to Company
helpdesk/intercom/company_tag_add · Action
Tag a company in Intercom. If a tag with this name doesn't exist yet, it's created automatically.
| Field | Type | Details | |
|---|---|---|---|
| Tag Name | string | Required | e.g. VIP customer — created if it doesn't exist yet |
| Company | string | Required · ● live picker | The company to tag — Intercom's company ID, not your own |
Returns: id, result, tool_result, success, error
Intercom: Remove Tag from Company
helpdesk/intercom/company_tag_remove · Action
Remove a tag from a company in Intercom. The tag itself is kept, so it stays available for other companies and contacts.
| Field | Type | Details | |
|---|---|---|---|
| Tag Name | string | Required | The exact name of the tag to remove, e.g. VIP customer |
| Company | string | Required · ● live picker | The company to remove the tag from — Intercom's company ID, not your own |
Returns: id, result, tool_result, success, error
05Contact
Intercom: Archive Contact
helpdesk/intercom/contact_archive · Action
Archive a contact to hide them from your Intercom workspace without deleting their data. Bring them back any time with Unarchive Contact.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The Intercom ID of the contact to archive |
Returns: id, result, tool_result, success, error
Intercom: Create Contact
helpdesk/intercom/contact_create · Action
Create a person in Intercom as a user or a lead. Provide at least an Email or an External ID so Intercom can identify them; everything else is optional.
| Field | Type | Details | |
|---|---|---|---|
| Role | string | choices: User, Lead | |
string | jane@acme.com — provide this or an External ID | ||
| External ID | string | Your own ID for this person, e.g. their ID in your database | |
| Phone | string | +15551234567 (include the country code) | |
| Name | string | Jane Doe | |
| Avatar URL | string | https://… — an image shown on the contact's profile | |
| Signed Up At | datetime | When they signed up, e.g. 2026-07-08T09:00:00Z | |
| Last Seen At | datetime | When they were last active | |
| Owner | string | ● live picker | The teammate who owns this contact |
| Unsubscribed From Emails | boolean | Tick to opt this person out of email | |
| Custom Attributes (JSON) | object | {"plan_tier":"gold"} — attributes must already exist in Intercom (Settings → Data) | |
| Additional Fields (JSON) | object | Any other Intercom contact field, e.g. {"unsubscribed_from_sms":true} |
Returns: id, result, tool_result, success, error
Intercom: Delete Contact
helpdesk/intercom/contact_delete · Action
Permanently delete a contact from Intercom. This can't be undone — use Archive Contact instead if you might need them back.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The Intercom ID of the contact to delete |
Returns: id, result, tool_result, success, error
Intercom: Get Contact
helpdesk/intercom/contact_get · Action
Look up a single Intercom contact, either by their Intercom Contact ID or by the External ID you gave them.
| Field | Type | Details | |
|---|---|---|---|
| Find By | string | choices: Contact ID, External ID | |
| Value | string | Required | The Contact ID (or your External ID) to look up |
Returns: id, result, tool_result, success, error
Intercom: Get Many Contacts
helpdesk/intercom/contact_get_all · Action
List the contacts in your Intercom workspace. Enable Return All to fetch every contact automatically; to narrow by field values use Search Contacts instead.
| Field | Type | Details | |
|---|---|---|---|
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every contact (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Merge Contacts
helpdesk/intercom/contact_merge · Action
Merge a lead into a user so their conversations and details live on one contact. Intercom only supports merging a lead into a user — not the other way round.
| Field | Type | Details | |
|---|---|---|---|
| Lead Contact ID | string | Required | The lead being merged — their conversations move to the user |
| User Contact ID | string | Required | The user who absorbs the lead |
Returns: id, result, tool_result, success, error
Intercom: Search Contacts
helpdesk/intercom/contact_search · Action
Find contacts matching a filter — e.g. everyone whose email ends with @acme.com. Date filters match at day granularity, and brand-new contacts can take a few minutes to become searchable.
| Field | Type | Details | |
|---|---|---|---|
| Field | string | The field to filter on, e.g. email, name, role, external_id, created_at | |
| Operator | string | choices: Equals, Not equals, Is any of (comma-separated), Is none of (comma-separated), Greater than, Less than, Contains, Doesn't contain, Starts with, Ends with | |
| Value | string | The value to match — comma-separate several values for the any of/none of operators | |
| Advanced Query (JSON) | object | A full Intercom search query for AND/OR combinations — overrides Field/Operator/Value, e.g. {"operator":"AND","value":[…]} | |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every match (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Add Tag to Contact
helpdesk/intercom/contact_tag_add · Action
Apply a tag to a contact — handy for segmenting people. Pick from your workspace's existing tags (use Create/Update Tag to make a new one).
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The contact's Intercom ID |
| Tag | string | Required · ● live picker | The tag to apply |
Returns: id, result, tool_result, success, error
Intercom: Remove Tag from Contact
helpdesk/intercom/contact_tag_remove · Action
Take a tag off a contact. The tag itself isn't deleted — it just no longer applies to this person.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The contact's Intercom ID |
| Tag | string | Required · ● live picker | The tag to remove |
Returns: id, result, tool_result, success, error
Intercom: Unarchive Contact
helpdesk/intercom/contact_unarchive · Action
Bring an archived contact back into your Intercom workspace, with all their conversations and details intact.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The Intercom ID of the contact to unarchive |
Returns: id, result, tool_result, success, error
Intercom: Update Contact
helpdesk/intercom/contact_update · Action
Update a contact's details in Intercom. Only the fields you fill in change; switching Role from Lead to User converts the lead into a full user.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The contact's Intercom ID |
| Role | string | choices: User, Lead | |
string | jane@acme.com | ||
| External ID | string | Your own ID for this person, e.g. their ID in your database | |
| Phone | string | +15551234567 (include the country code) | |
| Name | string | Jane Doe | |
| Avatar URL | string | https://… — an image shown on the contact's profile | |
| Signed Up At | datetime | When they signed up, e.g. 2026-07-08T09:00:00Z | |
| Last Seen At | datetime | When they were last active | |
| Owner | string | ● live picker | The teammate who owns this contact |
| Unsubscribed From Emails | boolean | Tick to opt this person out of email | |
| Custom Attributes (JSON) | object | {"plan_tier":"gold"} — attributes must already exist in Intercom (Settings → Data) | |
| Additional Fields (JSON) | object | Any other Intercom contact field, e.g. {"unsubscribed_from_sms":true} |
Returns: id, result, tool_result, success, error
06Conversation
Intercom: Assign Conversation
helpdesk/intercom/conversation_assign · Action
Assign an Intercom conversation to a teammate or a team, or unassign it.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to assign |
| Acting Admin | string | Required · ● live picker | The teammate performing the assignment |
| Assign To | string | choices: Admin, Team, Unassign | |
| Assignee (Admin) | string | ● live picker | The teammate to hand the conversation to |
| Assignee (Team) | string | ● live picker | The team to hand the conversation to |
Returns: id, result, tool_result, success, error
Intercom: Close Conversation
helpdesk/intercom/conversation_close · Action
Close an Intercom conversation as an admin, optionally posting a final message to the customer.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to close |
| Admin | string | Required · ● live picker | The teammate closing the conversation |
| Closing Message | text | An optional final message posted when closing |
Returns: id, result, tool_result, success, error
Intercom: Convert Conversation to Ticket
helpdesk/intercom/conversation_convert_to_ticket · Action
Turn an Intercom conversation into a ticket of the type you choose. The conversation itself becomes the ticket (they share the same ID) — deleting the ticket also deletes the conversation.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to convert |
| Ticket Type | string | Required · ● live picker | The type of ticket to create |
| Ticket Attributes (JSON) | object | {"_default_title_":"Refund request"} — values for the ticket type's attributes |
Returns: id, result, tool_result, success, error
Intercom: Create Conversation
helpdesk/intercom/conversation_create · Action
Start a new conversation in Intercom on behalf of a contact — the message appears as if the user or lead wrote it themselves.
| Field | Type | Details | |
|---|---|---|---|
| From | string | choices: User, Lead | |
| Contact ID | string | Required | The Intercom ID of the contact starting the conversation |
| Message | text | Required | The first message of the conversation |
| Subject | string | An optional subject line | |
| Attachment URLs | string | Comma-separated file URLs to attach (up to 10) | |
| Created At | datetime | Backdate the conversation, e.g. 2026-07-08T09:00:00Z |
Returns: id, result, tool_result, success, error
Intercom: Get Conversation
helpdesk/intercom/conversation_get · Action
Fetch a single Intercom conversation with its full message history. Tick Plain Text to strip HTML from the message bodies.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation, e.g. 123456789 |
| Plain Text | boolean | Return message bodies as plain text instead of HTML |
Returns: id, result, tool_result, success, error
Intercom: Get Many Conversations
helpdesk/intercom/conversation_get_all · Action
List conversations in your Intercom workspace, newest first. Enable Return All to page through every conversation.
| Field | Type | Details | |
|---|---|---|---|
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every conversation (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Open Conversation
helpdesk/intercom/conversation_open · Action
Reopen a closed or snoozed Intercom conversation.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to reopen |
| Admin | string | Required · ● live picker | The teammate reopening the conversation |
Returns: id, result, tool_result, success, error
Intercom: Reply to Conversation
helpdesk/intercom/conversation_reply · Action
Add a reply to an Intercom conversation — a public comment or internal note as an admin, or a reply on the contact's behalf.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to reply to |
| Reply Type | string | choices: Comment (as admin), Internal note (as admin), As contact | |
| Admin | string | ● live picker | The teammate writing the reply |
| Contact ID | string | The Intercom ID of the contact to reply as | |
| Message | text | Required | The reply text (internal notes may include HTML) |
| Attachment URLs | string | Comma-separated file URLs to attach (up to 10) |
Returns: id, result, tool_result, success, error
Intercom: Search Conversations
helpdesk/intercom/conversation_search · Action
Find Intercom conversations matching a filter — by state, assignee, creation date, or any searchable field. Use Advanced Query (JSON) for AND/OR combinations.
| Field | Type | Details | |
|---|---|---|---|
| Field | string | The field to filter on, e.g. state, source.body, admin_assignee_id, created_at | |
| Operator | string | choices: Equals, Not equals, Is any of (comma-separated), Is none of (comma-separated), Greater than, Less than, Contains, Doesn't contain, Starts with, Ends with | |
| Value | string | The value to match — comma-separate several values for the any of/none of operators | |
| Advanced Query (JSON) | object | A full Intercom search query for AND/OR combinations — overrides Field/Operator/Value, e.g. {"operator":"AND","value":[…]} | |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every match (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Snooze Conversation
helpdesk/intercom/conversation_snooze · Action
Snooze an Intercom conversation until a date and time you choose — it reopens automatically then.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to snooze |
| Admin | string | Required · ● live picker | The teammate snoozing the conversation |
| Snooze Until | datetime | Required | When to bring it back, e.g. 2026-07-09T09:00:00Z |
Returns: id, result, tool_result, success, error
Intercom: Add Tag to Conversation
helpdesk/intercom/conversation_tag_add · Action
Add a tag to an Intercom conversation so it's easy to filter and report on.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to tag |
| Tag | string | Required · ● live picker | The tag to add |
| Admin | string | Required · ● live picker | The teammate applying the tag |
Returns: id, result, tool_result, success, error
Intercom: Remove Tag from Conversation
helpdesk/intercom/conversation_tag_remove · Action
Remove a tag from an Intercom conversation.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to untag |
| Tag | string | Required · ● live picker | The tag to remove |
| Admin | string | Required · ● live picker | The teammate removing the tag |
Returns: id, result, tool_result, success, error
Intercom: Update Conversation
helpdesk/intercom/conversation_update · Action
Change an Intercom conversation — mark it read, retitle it, link a company, or set custom attributes.
| Field | Type | Details | |
|---|---|---|---|
| Conversation ID | string | Required | The ID of the conversation to update |
| Mark Read | boolean | Tick to mark the conversation as read | |
| Title | string | A new title for the conversation | |
| Company ID | string | The Intercom company ID to link (not your own company_id) | |
| Custom Attributes (JSON) | object | {"issue_type":"billing"} — attributes must already exist in Intercom (Settings → Data) | |
| Additional Fields (JSON) | object | Any other Intercom conversation field |
Returns: id, result, tool_result, success, error
07Event
Intercom: Track Event
helpdesk/intercom/event_create · Action
Record a custom event on a contact's timeline in Intercom (e.g. ordered-item or plan-upgraded). Identify the person by Contact ID, External ID, or Email.
| Field | Type | Details | |
|---|---|---|---|
| Event Name | string | Required | ordered-item — short, past-tense, hyphenated names work best |
| Contact ID | string | The Intercom contact ID — provide this, an External ID, or an Email | |
| External ID | string | Your own ID for this person, e.g. their ID in your database | |
string | jane@acme.com | ||
| Occurred At | datetime | When the event happened — leave empty for right now | |
| Metadata (JSON) | object | {"order_id":"12345","price":"$29.95"} — simple key/value details stored with the event |
Returns: id, result, tool_result, success, error
Intercom: Get Many Events
helpdesk/intercom/event_get_all · Action
List the events recorded for one contact, newest first. Intercom keeps events queryable for around 90 days. Enable Summary Only for one row per event type with counts.
| Field | Type | Details | |
|---|---|---|---|
| Find Contact By | string | choices: Intercom ID, External ID, Email | |
| Value | string | Required | The contact's Intercom ID, external ID, or email — whichever matches Find Contact By |
| Summary Only | boolean | One row per event type with counts, instead of each individual event | |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every event (ignores Limit) |
Returns: results, count, total, tool_result, success, error
08Message
Intercom: Send Message
helpdesk/intercom/message_send · Action
Send an outbound in-app or email message from an admin to a contact. Emails also need a Subject; in-app messages just need a Body.
| Field | Type | Details | |
|---|---|---|---|
| Message Type | string | choices: In-app message, Email | |
| From (Admin) | string | Required · ● live picker | The teammate the message is sent from |
| To (Contact ID) | string | Required | The Intercom contact ID of the person to message |
| Recipient Type | string | choices: User, Lead | |
| Subject | string | The email subject line | |
| Body | text | Required | The message to send — emails may use HTML |
| Email Template | string | choices: Plain, Personal | |
| Open Conversation Immediately | boolean | Create the conversation straight away instead of waiting for the contact to reply |
Returns: id, result, tool_result, success, error
09Note
Intercom: Create Note
helpdesk/intercom/note_create · Action
Add a private note to a contact's timeline. Notes are only visible to your teammates — the contact never sees them.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The Intercom contact the note goes on |
| Note | text | Required | What your teammates should know about this contact — plain text or simple HTML |
| Author | string | ● live picker | The teammate the note is attributed to |
Returns: id, result, tool_result, success, error
Intercom: Get Note
helpdesk/intercom/note_get · Action
Fetch a single note by its ID.
| Field | Type | Details | |
|---|---|---|---|
| Note ID | string | Required | The ID of the note to fetch |
Returns: id, result, tool_result, success, error
Intercom: Get Many Notes
helpdesk/intercom/note_get_all · Action
List the private notes on a contact's timeline, newest first. Enable Return All to fetch every note.
| Field | Type | Details | |
|---|---|---|---|
| Contact ID | string | Required | The Intercom contact whose notes to fetch |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Return every note (ignores Limit) |
Returns: results, count, total, tool_result, success, error
10Segment
Intercom: Get Segment
helpdesk/intercom/segment_get · Action
Fetch a single segment by its ID.
| Field | Type | Details | |
|---|---|---|---|
| Segment | string | Required · ● live picker | The segment to fetch |
Returns: id, result, tool_result, success, error
Intercom: Get Many Segments
helpdesk/intercom/segment_get_all · Action
List the segments in your Intercom workspace — the saved smart groups of people you define in Intercom. Segments are read-only via the API.
| Field | Type | Details | |
|---|---|---|---|
| Include Contact Counts | boolean | Also return how many people are in each segment | |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Return every segment (ignores Limit) |
Returns: results, count, total, tool_result, success, error
11Tag
Intercom: Create or Update Tag
helpdesk/intercom/tag_create_update · Action
Create a tag in Intercom, or rename an existing one by also providing its Tag ID. Creating a name that already exists simply returns the existing tag.
| Field | Type | Details | |
|---|---|---|---|
| Tag Name | string | Required | VIP — created if it doesn't exist yet |
| Tag ID (rename) | string | Leave empty to create; provide an existing tag's ID to rename it |
Returns: id, result, tool_result, success, error
Intercom: Delete Tag
helpdesk/intercom/tag_delete · Action
Delete a tag from Intercom. A tag still applied to contacts, companies, or conversations can't be deleted — remove it from them first.
| Field | Type | Details | |
|---|---|---|---|
| Tag | string | Required · ● live picker | The tag to delete |
Returns: id, result, tool_result, success, error
Intercom: Get Many Tags
helpdesk/intercom/tag_get_all · Action
List the tags in your Intercom workspace — the labels you apply to contacts, companies, and conversations.
| Field | Type | Details | |
|---|---|---|---|
| Limit | string | Max results (default 50) | |
| Return All | boolean | Return every tag (ignores Limit) |
Returns: results, count, total, tool_result, success, error
12Team
Intercom: Get Team
helpdesk/intercom/team_get · Action
Retrieve a single team by ID, including the admins in it.
| Field | Type | Details | |
|---|---|---|---|
| Team | string | Required · ● live picker | The team to look up |
Returns: id, result, tool_result, success, error
Intercom: Get Many Teams
helpdesk/intercom/team_get_all · Action
List the teams in your Intercom workspace, including which admins belong to each.
| Field | Type | Details | |
|---|---|---|---|
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every team (ignores Limit) |
Returns: results, count, total, tool_result, success, error
13Ticket
Intercom: Create Ticket
helpdesk/intercom/ticket_create · Action
Create a new ticket in Intercom. Pick the ticket type, say who it's for (by Contact ID, email, or your external ID), and optionally add a title, description, and an assignee.
| Field | Type | Details | |
|---|---|---|---|
| Ticket Type | string | Required · ● live picker | The kind of ticket to create (from your Intercom ticket types) |
| Contact ID | string | The Intercom ID of the person this ticket is for | |
| Contact Email | string | jane@acme.com — used when no Contact ID is given | |
| Contact External ID | string | Your own ID for the person, e.g. their ID in your database | |
| Title | string | A short summary shown on the ticket | |
| Description | text | What the ticket is about | |
| Ticket Attributes (JSON) | object | {"priority":"High"} — attributes defined on the ticket type in Intercom | |
| Company ID | string | The Intercom company to file the ticket under | |
| Assign to Teammate | string | ● live picker | The teammate to assign the ticket to |
| Assign to Team | string | ● live picker | The team to assign the ticket to |
| Link to Conversation | string | A conversation ID to attach this ticket to | |
| Created At | datetime | Backdate the ticket, e.g. 2026-07-08T09:00:00Z |
Returns: id, result, tool_result, success, error
Intercom: Delete Ticket
helpdesk/intercom/ticket_delete · Action
Permanently delete an Intercom ticket by its ID. This can't be undone.
| Field | Type | Details | |
|---|---|---|---|
| Ticket ID | string | Required | The ticket to delete — from a Create Ticket step or a search |
Returns: id, result, tool_result, success, error
Intercom: Get Ticket
helpdesk/intercom/ticket_get · Action
Look up a single Intercom ticket by its ID and return everything on it — state, attributes, assignees, and the linked contacts.
| Field | Type | Details | |
|---|---|---|---|
| Ticket ID | string | Required | The ticket's ID — from a Create Ticket step or a search |
Returns: id, result, tool_result, success, error
Intercom: Reply to Ticket
helpdesk/intercom/ticket_reply · Action
Add a reply to an Intercom ticket — a customer-visible comment or an internal note as an admin, or a comment on the contact's behalf.
| Field | Type | Details | |
|---|---|---|---|
| Ticket ID | string | Required | The ticket to reply to — from a Create Ticket step or a search |
| Reply Type | string | choices: Comment (as admin), Internal note (as admin), As contact | |
| Admin | string | ● live picker | The teammate the reply is sent as |
| Contact ID | string | The Intercom ID of the contact the reply is from | |
| Message | text | Required | What to say — internal notes can include HTML |
| Attachment URLs | string | https://…/a.pdf, https://…/b.png — up to 10, comma-separated |
Returns: id, result, tool_result, success, error
Intercom: Search Tickets
helpdesk/intercom/ticket_search · Action
Find Intercom tickets matching a filter — for example every ticket in a given state, assigned to a teammate, or created after a date. Use the advanced JSON query for AND/OR combinations.
| Field | Type | Details | |
|---|---|---|---|
| Field | string | e.g. state — also ticket_type_id, admin_assignee_id, created_at, or open | |
| Operator | string | choices: Equals, Not equals, Is any of (comma-separated), Is none of (comma-separated), Greater than, Less than, Contains, Doesn't contain, Starts with, Ends with | |
| Value | string | e.g. in_progress — comma-separate several values for the any of/none of operators | |
| Advanced Query (JSON) | object | A full Intercom search query for AND/OR combinations — overrides Field/Operator/Value, e.g. {"operator":"AND","value":[…]} | |
| Limit | string | Max results (default 50) | |
| Return All | boolean | Fetch every match (ignores Limit) |
Returns: results, count, total, tool_result, success, error
Intercom: Add Tag to Ticket
helpdesk/intercom/ticket_tag_add · Action
Add an existing tag to an Intercom ticket so it's easy to group, filter, and report on.
| Field | Type | Details | |
|---|---|---|---|
| Ticket ID | string | Required | The ticket to tag — from a Create Ticket step or a search |
| Tag | string | Required · ● live picker | The tag to add — it must already exist in Intercom |
| Admin | string | Required · ● live picker | The teammate applying the tag (for attribution) |
Returns: id, result, tool_result, success, error
Intercom: Remove Tag from Ticket
helpdesk/intercom/ticket_tag_remove · Action
Take a tag off an Intercom ticket. The tag itself is kept — only its link to this ticket is removed.
| Field | Type | Details | |
|---|---|---|---|
| Ticket ID | string | Required | The ticket to untag — from a Create Ticket step or a search |
| Tag | string | Required · ● live picker | The tag to remove from the ticket |
| Admin | string | Required · ● live picker | The teammate removing the tag (for attribution) |
Returns: id, result, tool_result, success, error
Intercom: Update Ticket
helpdesk/intercom/ticket_update · Action
Change an Intercom ticket — edit its title, description, or attributes, move it to another state, snooze or reopen it, or hand it to a different teammate or team.
| Field | Type | Details | |
|---|---|---|---|
| Ticket ID | string | Required | The ticket to change — from a Create Ticket step or a search |
| Title | string | A new short summary for the ticket | |
| Description | text | A new description of what the ticket is about | |
| Ticket Attributes (JSON) | object | {"priority":"High"} — attributes defined on the ticket type in Intercom | |
| Ticket State | string | ● live picker | Move the ticket to this state, e.g. In Progress or Resolved |
| Open | boolean | Tick to reopen the ticket; untick to close it | |
| Snooze Until | datetime | Hide the ticket until this time, e.g. 2026-07-10T09:00:00Z | |
| Acting Admin | string | ● live picker | The teammate making this change — required when setting an assignee |
| Assignee ID | string | A teammate or team ID to hand the ticket to — 0 to unassign (needs Acting Admin too) | |
| Visible to Customer | boolean | Tick to show the ticket to the contact in the Messenger |
Returns: id, result, tool_result, success, error
14Triggers
Intercom Webhook Trigger
trigger/intercom_webhook · Trigger
Triggers a flow when something happens in your Intercom workspace — a new conversation starts, a customer replies, a ticket changes state, a contact is created, and so on. Intercom doesn't let apps register webhooks automatically, so paste the trigger's webhook URL into your Intercom Developer Hub app under Configure → Webhooks and pick the topics to send.
| Field | Type | Details | |
|---|---|---|---|
| Only Fire On | string | Which Intercom event to fire on (default: all) — choices: All events, New conversation started, Customer replied to conversation, Teammate replied to conversation, Conversation assigned, Conversation closed, Conversation opened, Conversation snoozed, Note added to conversation, Conversation rated, Conversation priority changed, Contact created (user), Lead created, Contact updated (user), Lead updated, Lead signed up (became a user), Contact email updated, Contacts merged, Contact deleted, Contact archived, Contact subscribed to emails, Contact unsubscribed from emails, Ticket created, Ticket state changed, Ticket closed, Ticket assigned to teammate, Ticket assigned to team, Teammate replied to ticket, Customer replied to ticket, Note added to ticket, Ticket rated, Company created, Company updated, Company deleted, Article published, Event tracked, Visitor signed up, Teammate away mode changed |
Returns: content, topic, item_type, item_id, conversation_id, ticket_id, contact_id, company_id, admin_id, app_id, created_at, body
15Notes & Limitations
Behaviours and constraints worth knowing before you build with these nodes.
- Search and name lookups are eventually consistent — newly created or edited contacts, companies (by name), and articles can take a few minutes to appear, so fetch by ID when you need the record instantly.
- Companies only become visible in Intercom once at least one contact is attached, so a freshly created company won't list or show up until you attach someone.
- Converting a conversation to a ticket makes them the same record sharing one ID — deleting that ticket also deletes the underlying conversation.
- Contacts can only be merged one way: a lead into a user, never a user into a lead or two users together.
- A tag that is still applied to any contact, company, or conversation cannot be deleted — remove it everywhere first.
- Event history is only queryable for around 90 days, so pull events you need to keep well within that window.