Intercom

Manage conversations, contacts, and companies with the Intercom API.

Detail	Value
Category	Support
Base URL	https://api.intercom.io
Authentication	Bearer Token
Endpoints	6
Connector key	intercom

Using Intercom in a workflow

1. Go to Connections and click New Connection.
2. Pick Intercom from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /conversations	List conversations
GET /conversations/{id}	Get a conversation
POST /conversations/{id}/reply	Reply to a conversation
POST /contacts	Create a contact
POST /contacts/search	Search contacts
GET /companies	List companies

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /conversations

List conversations

Detail	Value
Operation ID	support.listConversations
Method	GET
Path	/conversations

Parameters

Name	Location	Type	Required
per_page	query	integer	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Intercom connection from the Connection dropdown.
3. In the Operation dropdown, select support.listConversations.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Intercom API reference.

GET /conversations/{id}

Get a conversation

Detail	Value
Operation ID	support.getConversation
Method	GET
Path	/conversations/{id}

Parameters

Name	Location	Type	Required
id	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Intercom connection from the Connection dropdown.
3. In the Operation dropdown, select support.getConversation.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Intercom API reference.

POST /conversations/{id}/reply

Reply to a conversation

Detail	Value
Operation ID	support.replyToConversation
Method	POST
Path	/conversations/{id}/reply

Parameters

Name	Location	Type	Required
id	path	string	Yes

Request Body

Field	Type
message_type	string
type	string
body	string

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Intercom connection from the Connection dropdown.
3. In the Operation dropdown, select support.replyToConversation.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Intercom API reference.

POST /contacts

Create a contact

Detail	Value
Operation ID	support.createContact
Method	POST
Path	/contacts

Parameters

No parameters.

Request Body

Field	Type
role	string
email	string
name	string

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Intercom connection from the Connection dropdown.
3. In the Operation dropdown, select support.createContact.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Intercom API reference.

POST /contacts/search

Search contacts

Detail	Value
Operation ID	support.searchContacts
Method	POST
Path	/contacts/search

Parameters

No parameters.

Request Body

Field	Type
query	object

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Intercom connection from the Connection dropdown.
3. In the Operation dropdown, select support.searchContacts.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Intercom API reference.

GET /companies

List companies

Detail	Value
Operation ID	support.listCompanies
Method	GET
Path	/companies

Parameters

Name	Location	Type	Required
per_page	query	integer	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Intercom connection from the Connection dropdown.
3. In the Operation dropdown, select support.listCompanies.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Intercom API reference.