Customer messaging platform

Go to site

Intercom API Integrations

Build and run workflows using the Intercom API. Use 1000s of open source triggers and actions across 500+ apps. Or write custom code to integrate any app or API in seconds.

return await require("@pipedreamhq/platform").axios(this, {
  url: ``,
  headers: {
    Authorization: `Bearer ${auths.intercom.oauth_access_token}`,
    "Accept": `application/json`,
Add or update contact with custom_attributes

Takes options contact id (manual or previous step/event) and updates or creates a new user or lead, with ability to add custom_attributes

Try it
Find first contact by email

Returns the first contact (user or lead) by searching using an email. The param ContactType is either intercom's "user" or "lead". Returns null if no user found, also stores the found contact in the contact variable, in addition to the $return_value

Try it
List All Tags

Lists all tags.

Try it
Tag contact

Tag an Intercom contact (using contact id) with a tag (using the tag name/string)

Try it
Create Contact

Creates a new contact (ie. user or lead).

Try it


Intercom uses OAuth authentication. When you connect your Intercom account, Pipedream will open a popup window where you can sign into Intercom and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Intercom API.

Pipedream requests the following authorization scopes when you connect your account:

OAuth Request Configurations:
  1. authorization
  2. accessToken
    POST application/x-www-form-urlencodedaccept: application/json