Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Intercom

Connect Intercom with Flows360 to automate customer-support workflows.

CategorySupport
Authenticationcustom
Version0.8.0
Published scopes0 published scopes
Last updatedSeptember 19, 2026

Overview

Connect Intercom with Flows360

Connect Intercom with Flows360 to automate customer-support workflows.

Use the Intercom connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 26 actions and 22 triggers.

Available actions

  • Add Note
  • Add note to conversation
  • Add/Remove Tag on Contact
  • Add/Remove Tag on Company
  • Add/Remove Tag on Conversation
  • Assign conversation to an admin or a team
  • Create Article
  • Create Conversation
  • Plus 18 additional declared actions.

Available triggers

  • Contact Replied
  • Lead Added Email
  • Lead Converted To User
  • Conversation Closed
  • Conversation assigned to any Intercom admin
  • Conversation snoozed
  • Plus 16 additional declared triggers.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Intercom
  • Package: @activepieces/piece-intercom@0.8.0
  • Exact artifact digest: sha256:2d7d98cd529477eab7f9fad7986b6e643e20c33a26401c9937339375c031cddc
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

OAUTH2, CUSTOM AUTH. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Add Note (add-note-to-user), Add a note to a user Classification: read.
  • Add note to conversation (addNoteToConversation), Add a note (for other admins) to an existing conversation Classification: read.
  • Add/Remove Tag on Contact (add-or-remove-tag-on-contact), Attach or remove a tag from a specific contact. Classification: read.
  • Add/Remove Tag on Company (add-or-remove-tag-on-company), Attach or remove a tag from a specific company. Classification: read.
  • Add/Remove Tag on Conversation (add-or-remove-tag-on-conversation), Attach or remove a tag from a specific conversation. Classification: read.
  • Assign conversation to an admin or a team (assignConversationAction), (Re)assign conversation to a specific admin or team. Classification: read.
  • Create Article (create-article), Creates a new article in your Help Center. Classification: read.
  • Create Conversation (create-conversation), Creates a new conversation from a contact. Classification: read.
  • Create Data Event (create-data-event), Submits a data event for a contact. Classification: read.
  • Create Ticket (create-ticket), Creates a new ticket. Classification: read.
  • Create User (create-user), Creates a new user. Classification: read.
  • Create or Update Company (create-or-update-company), Creates a new company or updates an existing one (matched by Company ID). Classification: read.
  • Create or Update Lead (create-or-update-lead), Create or update an Intercom lead.If an ID is provided, the lead will be updated. Classification: read.
  • Create/Update User (create-or-update-user), Update a user within intercom given an email address. Classification: read.
  • Reply to conversation (replyToConversation), Reply (as an admin) to a conversation with a contact Classification: read.
  • Send Message (send_message), Send a message to a contact (only allowed by admins) Classification: read.
  • Update Ticket (update-ticket), Updates an existing ticket. Classification: read.
  • Find Company (find-company), Finds an existing company. Classification: read.
  • Find Conversation (find-conversation), Searches for conversations using various criteria Classification: read.
  • Find Lead (find-lead), Finds an existing lead. Classification: read.
  • Find or Create Company (find-or-create-company), Finds a company by Company ID or name, creating it if none is found. Classification: read.
  • Find or Create Lead (find-or-create-lead), Finds a lead by email, ID, or User ID, creating it if none is found. Classification: read.
  • Find User (find-user), Finds an existing user. Classification: read.
  • List Tags (list-all-tags), List all tags. Classification: read.
  • Retrieve a Conversation (get-conversation), Retrieves a specific conversation by ID. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • Contact Replied, app webhook.
  • Lead Added Email, app webhook.
  • Lead Converted To User, app webhook.
  • Conversation Closed, app webhook.
  • Conversation assigned to any Intercom admin, app webhook.
  • Conversation snoozed, app webhook.
  • Conversation unsnoozed, app webhook.
  • New Company, app webhook.
  • New Conversation, app webhook.
  • Conversation was rated, app webhook.
  • New Lead, app webhook.
  • New Ticket, app webhook.
  • New Unsubscription, app webhook.
  • New User, app webhook.
  • Updated Ticket, app webhook.
  • Tag added to a conversation part, app webhook.
  • Tag Added to Lead, app webhook.
  • Tag Added to User, app webhook.
  • Updated Contact, app webhook.
  • Reply from a user or lead, app webhook.
  • Reply from an Intercom admin, app webhook.
  • Note added to conversation, app webhook.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authenticationcustom
Supported objects48
Supported actions26
Triggers22

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • Access token Required · protected credential
  • Region Required
connection_2 · custom
  • Access Token Required · protected credential
  • Region Required

Supported objects

ObjectReadWriteNotes
Add Note Yes No Add a note to a user
Add note to conversation Yes No Add a note (for other admins) to an existing conversation
Add/Remove Tag on Contact Yes No Attach or remove a tag from a specific contact.
Add/Remove Tag on Company Yes No Attach or remove a tag from a specific company.
Add/Remove Tag on Conversation Yes No Attach or remove a tag from a specific conversation.
Assign conversation to an admin or a team Yes No (Re)assign conversation to a specific admin or team.
Create Article Yes No Creates a new article in your Help Center.
Create Conversation Yes No Creates a new conversation from a contact.
Create Data Event Yes No Submits a data event for a contact.
Create Ticket Yes No Creates a new ticket.
Create User Yes No Creates a new user.
Create or Update Company Yes No Creates a new company or updates an existing one (matched by Company ID).
Create or Update Lead Yes No Create or update an Intercom lead.If an ID is provided, the lead will be updated.
Create/Update User Yes No Update a user within intercom given an email address.
Reply to conversation Yes No Reply (as an admin) to a conversation with a contact
Send Message Yes No Send a message to a contact (only allowed by admins)
Update Ticket Yes No Updates an existing ticket.
Find Company Yes No Finds an existing company.
Find Conversation Yes No Searches for conversations using various criteria
Find Lead Yes No Finds an existing lead.
Find or Create Company Yes No Finds a company by Company ID or name, creating it if none is found.
Find or Create Lead Yes No Finds a lead by email, ID, or User ID, creating it if none is found.
Find User Yes No Finds an existing user.
List Tags Yes No List all tags.
Retrieve a Conversation Yes No Retrieves a specific conversation by ID.
Custom API Call Yes No Make a custom API call to a specific endpoint
Contact Replied Yes No app webhook trigger declared by the pinned package.
Lead Added Email Yes No app webhook trigger declared by the pinned package.
Lead Converted To User Yes No app webhook trigger declared by the pinned package.
Conversation Closed Yes No app webhook trigger declared by the pinned package.
Conversation assigned to any Intercom admin Yes No app webhook trigger declared by the pinned package.
Conversation snoozed Yes No app webhook trigger declared by the pinned package.
Conversation unsnoozed Yes No app webhook trigger declared by the pinned package.
New Company Yes No app webhook trigger declared by the pinned package.
New Conversation Yes No app webhook trigger declared by the pinned package.
Conversation was rated Yes No app webhook trigger declared by the pinned package.
New Lead Yes No app webhook trigger declared by the pinned package.
New Ticket Yes No app webhook trigger declared by the pinned package.
New Unsubscription Yes No app webhook trigger declared by the pinned package.
New User Yes No app webhook trigger declared by the pinned package.
Updated Ticket Yes No app webhook trigger declared by the pinned package.
Tag added to a conversation part Yes No app webhook trigger declared by the pinned package.
Tag Added to Lead Yes No app webhook trigger declared by the pinned package.
Tag Added to User Yes No app webhook trigger declared by the pinned package.
Updated Contact Yes No app webhook trigger declared by the pinned package.
Reply from a user or lead Yes No app webhook trigger declared by the pinned package.
Reply from an Intercom admin Yes No app webhook trigger declared by the pinned package.
Note added to conversation Yes No app webhook trigger declared by the pinned package.

Supported actions

Add Note · Read

Add a note to a user

add_note_to_user · Risk: low · Retry: safe

Inputs

  • email · string · Required
  • body · string · Required
Add note to conversation · Read

Add a note (for other admins) to an existing conversation

add_note_to_conversation · Risk: low · Retry: safe

Inputs

  • from · string · Required
  • conversationId · string · Required
  • body · string · Required
Add/Remove Tag on Contact · Read

Attach or remove a tag from a specific contact.

add_or_remove_tag_on_contact · Risk: low · Retry: safe

Inputs

  • contactId · string · Required
  • tagId · string · Required
  • untag · boolean · Optional
Add/Remove Tag on Company · Read

Attach or remove a tag from a specific company.

add_or_remove_tag_on_company · Risk: low · Retry: safe

Inputs

  • companyId · string · Required
  • tagName · string · Required
  • untag · boolean · Optional
Add/Remove Tag on Conversation · Read

Attach or remove a tag from a specific conversation.

add_or_remove_tag_on_conversation · Risk: low · Retry: safe

Inputs

  • conversationId · string · Required
  • tagId · string · Required
  • untag · boolean · Optional
Assign conversation to an admin or a team · Read

(Re)assign conversation to a specific admin or team.

assign_conversation_action · Risk: low · Retry: safe

Inputs

  • from · string · Required
  • conversationId · string · Required
  • assigneeId · string · Required, The ID of the admin or team to assign this conversation to
  • body · string · Optional
Create Article · Read

Creates a new article in your Help Center.

create_article · Risk: low · Retry: safe

Inputs

  • title · string · Required
  • description · string · Optional
  • body · string · Optional
  • authorId · string · Required
  • state · string · Required
  • collectionId · string · Optional
Create Conversation · Read

Creates a new conversation from a contact.

create_conversation · Risk: low · Retry: safe

Inputs

  • contactType · string · Required
  • contactId · string · Required
  • body · string · Required
Create Data Event · Read

Submits a data event for a contact.

create_data_event · Risk: low · Retry: safe

Inputs

  • identifierType · string · Required
  • identifierValue · string · Required
  • eventName · string · Required, The name of the event that occurred.
  • createdAt · string · Optional, When the event happened. Defaults to now if left empty.
  • metadata · object · Optional, Optional key/value pairs describing the event.
Create Ticket · Read

Creates a new ticket.

create_ticket · Risk: low · Retry: safe

Inputs

  • ticketTypeId · string · Required
  • contactId · string · Required
  • companyId · string · Optional
  • ticketProperties · object · Required
Create User · Read

Creates a new user.

create_user · Risk: low · Retry: safe

Inputs

  • email · string · Required
  • createdAt · string · Optional
  • userId · string · Optional
  • name · string · Optional
  • customAttributes · object · Optional
Create or Update Company · Read

Creates a new company or updates an existing one (matched by Company ID).

create_or_update_company · Risk: low · Retry: safe

Inputs

  • companyId · string · Optional, The company ID you have defined for the company. Cannot be updated later.
  • name · string · Optional
  • plan · string · Optional
  • size · number · Optional, The number of employees in this company.
  • website · string · Optional
  • industry · string · Optional
  • monthlySpend · number · Optional, How much revenue the company generates for your business (whole integers only).
  • remoteCreatedAt · string · Optional, The time the company was created by you.
  • customAttributes · object · Optional
Create or Update Lead · Read

Create or update an Intercom lead.If an ID is provided, the lead will be updated.

create_or_update_lead · Risk: low · Retry: safe

Inputs

  • leadId · string · Optional
  • name · string · Optional
  • email · string · Optional
  • phone · string · Optional
  • unsubscribe · boolean · Optional
  • createdAt · string · Optional
  • customAttributes · object · Optional
Create/Update User · Read

Update a user within intercom given an email address.

create_or_update_user · Risk: low · Retry: safe

Inputs

  • email · string · Required
  • name · string · Optional
  • userId · string · Optional
  • phone · string · Optional
  • createdAt · string · Optional
  • customAttributes · object · Optional
Reply to conversation · Read

Reply (as an admin) to a conversation with a contact

reply_to_conversation · Risk: low · Retry: safe

Inputs

  • from · string · Required
  • conversationId · string · Required
  • body · string · Required
Send Message · Read

Send a message to a contact (only allowed by admins)

send_message · Risk: low · Retry: safe

Inputs

  • message_type · string · Required
  • email_required_fields · object · Required
  • from · string · Required
  • to · string · Required
  • body · string · Required
  • create_conversation_without_contact_reply · boolean · Optional, Whether a conversation should be opened in the inbox for the message without the contact replying. Defaults to false if not provided.
Update Ticket · Read

Updates an existing ticket.

update_ticket · Risk: low · Retry: safe

Inputs

  • ticketTypeId · string · Required
  • ticketId · string · Required
  • ticketProperties · object · Required
  • isOpen · boolean · Optional
  • state · string · Optional
  • snoozedTill · string · Optional
  • assignedAdminId · string · Optional
Find Company · Read

Finds an existing company.

find_company · Risk: low · Retry: safe

Inputs

  • searchField · string · Required
  • searchValue · string · Required
Find Conversation · Read

Searches for conversations using various criteria

find_conversation · Risk: low · Retry: safe

Inputs

  • searchField · string · Required
  • matchType · string · Required
  • searchTerm · string · Required
  • status · string · Optional
  • updateAfter · string · Optional
  • updateBefore · string · Optional
Find Lead · Read

Finds an existing lead.

find_lead · Risk: low · Retry: safe

Inputs

  • searchField · string · Required
  • searchValue · string · Required
Find or Create Company · Read

Finds a company by Company ID or name, creating it if none is found.

find_or_create_company · Risk: low · Retry: safe

Inputs

  • companyId · string · Optional, The company ID you have defined for the company. Used to look up and create.
  • name · string · Optional, Used to look up by name when no Company ID is given, and when creating.
  • plan · string · Optional
  • size · number · Optional
  • website · string · Optional
  • industry · string · Optional
  • customAttributes · object · Optional
Find or Create Lead · Read

Finds a lead by email, ID, or User ID, creating it if none is found.

find_or_create_lead · Risk: low · Retry: safe

Inputs

  • searchField · string · Required
  • searchValue · string · Required
  • name · string · Optional
  • phone · string · Optional
  • customAttributes · object · Optional
Find User · Read

Finds an existing user.

find_user · Risk: low · Retry: safe

Inputs

  • searchField · string · Required
  • searchValue · string · Required
List Tags · Read

List all tags.

list_all_tags · Risk: low · Retry: safe

Retrieve a Conversation · Read

Retrieves a specific conversation by ID.

get_conversation · Risk: low · Retry: safe

Inputs

  • conversationId · string · Required
Custom API Call · Read

Make a custom API call to a specific endpoint

custom_api_call · Risk: low · Retry: safe

Inputs

  • url · object · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_is_binary · boolean · Optional, Enable for files like PDFs, images, etc.
  • failsafe · boolean · Optional, On a failed request, output the error instead of failing the step.
  • timeout · number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).
  • followRedirects · boolean · Optional, Follow 3xx redirects instead of returning them as the response.

Triggers

Contact Replied · Webhook

Triggers when a contact replies to a Conversation in Intercom.

Lead Added Email · Webhook

Triggers when a lead enters an email address.

Lead Converted To User · Webhook

Triggers when a lead is converted to a user.

Conversation Closed · Webhook

Triggers when a conversation is closed.

Conversation assigned to any Intercom admin · Webhook

Triggers when a conversation is assigned to an admin

Conversation snoozed · Webhook

Triggers when a conversation is snoozed

Conversation unsnoozed · Webhook

Triggers when a conversation is unsnoozed

New Company · Webhook

Triggers when a new company is created.

New Conversation · Webhook

Triggers when a conversation is created by a user or lead (not an admin).

Conversation was rated · Webhook

Triggers when a conversation is rated

New Lead · Webhook

Triggers when a new lead is created.

New Ticket · Webhook

Triggers when a new ticket is created.

New Unsubscription · Webhook

Triggers when a contact unsubscribes from your emails.

New User · Webhook

Triggers when a new user is created.

Updated Ticket · Webhook

Triggers when a ticket is updated (state or attributes change).

Tag added to a conversation part · Webhook

Triggers when a conversation part is tagged.

Inputs

  • tagId · string
Tag Added to Lead · Webhook

Triggers when a tag is added to a lead.

Inputs

  • tagId · string
Tag Added to User · Webhook

Triggers when a tag is added to a user.

Inputs

  • tagId · string
Updated Contact · Webhook

Triggers when a contact is updated.

Inputs

  • type · string
Reply from a user or lead · Webhook

Triggers when a reply is received from a user or lead (not an admin)

Reply from an Intercom admin · Webhook

Triggers when a reply is received from an Intercom admin (not a user or lead)

Note added to conversation · Webhook

Triggers when a note is added to a conversation

Inputs

  • keyword · string

Setup

Setup

  1. Add the Intercom connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • Region (region), required.
  • Access Token (accessToken), required; stored as a sensitive connection value.
  • Region (region), required.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-intercom@0.8.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 26 actions and 22 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Intercom connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-intercom@0.8.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com