Explore 22 workflow actions for Intercom, including account permissions and operation limits.
11 read actions11 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Assign conversation
Write
Assign or unassign a conversation to an admin or team, attributed to the acting admin.
Permissions and limits
Account permissions
Write conversations
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Conversation APIs require separate Read tickets or Write tickets permission when the target is an Intercom ticket.
Assignment is changed without an accompanying customer message. Admin and team assignment are independent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Close conversation
Write
Close a conversation as a teammate, with an optional closing message.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create contact
Write
Create a user or lead with an email.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
An email that more than one user already has is refused (409).
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create or update company
Write
Create a company with your own company_id, or update the company that already has it.
Permissions and limits
Account permissions
Write users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Intercom shows a company only once at least one contact is attached.
An existing company_id updates that company instead of creating one.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete contact
Write
Delete one contact by its exact Intercom ID. The provider must confirm deleted:true.
Permissions and limits
Account permissions
Read and write users
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
This deletes the contact; it does not merely archive or unsubscribe them.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Find company
Read
Find one company by your own company_id or by its exact name.
Permissions and limits
Account permissions
Read and list users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Intercom answers 404 when no company matches.
Find contact by email
Read
Find contacts whose email is exactly the one given. A contact made in the last few minutes may not be found yet.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
US workspaces only (api.intercom.io): EU and Australian workspaces use other hosts.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Get company
Read
Read one company by its Intercom ID.
Permissions and limits
Account permissions
Read and list users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Get contact
Read
Read one Intercom contact by its provider ID.
Permissions and limits
Account permissions
Read one user and one company
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Get conversation
Read
Read a conversation, its state and its latest parts, as plain text.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
Only the most recent 500 conversation parts are returned.
List companies
Read
Read one page of companies, most recently active first unless the order is asc.
Permissions and limits
Account permissions
Read and list users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Companies with no contacts are not listed. Intercom stops at 10,000 companies through paging.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List company contacts
Read
Read the users and leads attached to a company.
Permissions and limits
Account permissions
Read and list users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
List contacts
Read
List a page of users and leads. Use pages.next.starting_after to continue.
Permissions and limits
Account permissions
Read and list users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Merged source contacts are absent; only the target contact remains in list results. One page per execution.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List conversations
Read
Read a page of conversations.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Reopen conversation
Write
Reopen a closed or snoozed conversation, attributed to the acting admin.
Permissions and limits
Account permissions
Write conversations
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Conversation APIs require separate Read tickets or Write tickets permission when the target is an Intercom ticket.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply to conversation
Write
Reply as a teammate: a comment the customer sees, or a note only the team sees.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Search contacts
Read
Search users and leads with a typed attribute comparison and explicit pagination.
Permissions and limits
Account permissions
Read and list users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
New contacts may take minutes to enter search. Date filters match calendar days in the Intercom workspace timezone, not exact timestamps.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Search conversations
Read
Find conversations by state, customer, assignment, timestamps or another supported attribute.
Permissions and limits
Account permissions
Read conversations
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Conversation APIs require separate Read tickets or Write tickets permission when the target is an Intercom ticket.
Search returns summary records. Read an individual conversation for its latest 500 parts. Source-body matching is token-based.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Snooze conversation
Write
Snooze a conversation until a specified Unix timestamp in seconds.
Permissions and limits
Account permissions
Write conversations
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Conversation APIs require separate Read tickets or Write tickets permission when the target is an Intercom ticket.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update company
Write
Update a company by its Intercom ID without replacing other fields.
Permissions and limits
Account permissions
Write users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Your own company_id cannot be changed.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update contact
Write
Update selected contact attributes without replacing other fields.
Permissions and limits
Account permissions
Write users and companies
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
This operation updates existing fields. Clearing standard fields with null and changing role are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update conversation
Write
Change a conversation's title, read state, company or scalar custom attributes.
Permissions and limits
Account permissions
Write conversations
Operation limits
US workspaces only: this connector uses api.intercom.io, not the EU or Australian host.
Conversation APIs require separate Read tickets or Write tickets permission when the target is an Intercom ticket.
Duplicate custom-attribute names are rejected by Intercom. Clearing the company association with null is not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Intercom. A saved workflow is not a completed provider action.
