Intercom actions let an agent manage contacts directly in a flow. An agent can create, update, retrieve, delete, and list contacts, then pass the results to later steps.Documentation Index
Fetch the complete documentation index at: https://explore.airia.com/llms.txt
Use this file to discover all available pages before exploring further.
Supported actions
| Group | Actions |
|---|---|
| Contact | Create, Update, Get, Delete, List |
Prerequisites
Create an Intercom credential
Create an Intercom credential
Store an Intercom access token as an Intercom credential in Credential Management, then select it on every Intercom action.
How to use these actions
- Map text inputs from earlier steps. Inputs such as Email, Name, and Contact ID accept a value mapped from a previous step.
- Fixed value inputs. The Per Page count and the Unsubscribed From Emails toggle are set to fixed values.
- Identifying a user contact. When creating a contact with the
userrole, provide either an Email or an External ID. - List results page with a cursor. To page through more contacts, pass the cursor from the previous response into Starting After on the next call.
Actions
Contact
Intercom Contact Create
Creates a new contact.| Input | Required | Description |
|---|---|---|
| Role | Yes | The contact role, either user or lead. Defaults to user. |
| Conditional | The contact’s email address. Required for a user role contact when External ID is not set. | |
| External ID | Conditional | A unique ID from your own system. Required for a user role contact when Email is not set. |
| Name | No | The contact’s name. |
| Phone | No | The contact’s phone number. |
| Avatar | No | A URL to an avatar image. |
A
user role contact requires an Email or an External ID. A lead does not.Intercom Contact Update
Updates an existing contact.| Input | Required | Description |
|---|---|---|
| Contact ID | Yes | The unique identifier of the contact to update. |
| No | The contact’s email address. | |
| External ID | No | A unique ID from your own system. |
| Name | No | The contact’s name. |
| Phone | No | The contact’s phone number. |
| Avatar | No | A URL to an avatar image. |
| Unsubscribed From Emails | No | Toggle. Whether the contact is unsubscribed from emails. |
Intercom Contact Get
Retrieves a contact by ID.| Input | Required | Description |
|---|---|---|
| Contact ID | Yes | The unique identifier of the contact to retrieve. |
Intercom Contact Delete
Deletes a contact.| Input | Required | Description |
|---|---|---|
| Contact ID | Yes | The unique identifier of the contact to delete. |
Intercom Contact List
Lists contacts.| Input | Required | Description |
|---|---|---|
| No | Filter results to contacts with this email address. | |
| Per Page | No | Number of contacts per page, from 1 to 150. Defaults to 50. |
| Starting After | No | Pagination cursor from a previous response. |
Example
An agent that keeps a contact record in sync after a support chat:Look up the contact
An Intercom Contact List action filters by the customer’s Email to find an existing record.
Create if missing
A branch runs Intercom Contact Create with Role set to
user and the customer’s Email when no match was found.Troubleshooting
A user contact requires an email or external ID
A user contact requires an email or external ID
A
user role contact must include either an Email or an External ID. Supply at least one, or set Role to lead.Authentication failed
Authentication failed
The access token is missing, expired, or revoked. Confirm the credential holds a valid Intercom access token and reconnect if needed.
Contact not found
Contact not found
The Contact ID does not exist in this workspace. Confirm the ID with a List action and that the token belongs to the right Intercom workspace.
Contact already exists
Contact already exists
A contact with the same email or external ID is already present. Use Contact List to find it, then Contact Update instead of creating a duplicate.