Intercom

  • Reference

Intercom makes messaging apps for businesses that help them understand and talk to consumers.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft
Website https://www.intercom.com/
Privacy policy https://www.intercom.com/legal/terms-and-policies#privacy

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 120 seconds

Actions

Create new lead

Creates a new lead for your Intercom account.
Create or update user

Creates a new user for your Intercom account. Users found via email will be updated.
Get lead

Given the id for an existing lead, this operation returns all information about the lead.
Get user

Given the id for an existing user, this operation returns all information about the user.
List all leads

Returns a list of all leads within your Intercom account.

Create new lead

Operation ID:
CreateLead

Creates a new lead for your Intercom account.

Parameters

Name Key Required Type Description
Email
 email True string
Name
 name string
Phone
 phone string
Image URL
 image_url string
Company Id
 companies string

Returns

Body
Lead_Response

Create or update user

Operation ID:
CreateUser

Creates a new user for your Intercom account. Users found via email will be updated.

Parameters

Name Key Required Type Description
Email
 email True string
Name
 name string
Phone
 phone string
Company Id
 companies string

Returns

Body
User_Response

Get lead

Operation ID:
GetLead

Given the id for an existing lead, this operation returns all information about the lead.

Parameters

Name Key Required Type Description
Lead Id
 contact_id True string

The id of the lead

Returns

Body
Lead_Response

Get user

Operation ID:
GetUser

Given the id for an existing user, this operation returns all information about the user.

Parameters

Name Key Required Type Description
User Id
 user_id True string

The id of the user

Returns

Body
User_Response

List all leads

Operation ID:
ListLeads

Returns a list of all leads within your Intercom account.

Returns

Items
ListLeads_Response

Triggers

When a lead is created

Triggers when a new lead is created.
When a new conversation starts

Triggers when a user starts a new conversation.
When a user is created

Triggers when a new user is created.
When a user is updated

Triggers when an existing user's information is updated.

When a lead is created

Operation ID:
TrigNewLead

Triggers when a new lead is created.

Returns

Body
TrigLead_Response

When a new conversation starts

Operation ID:
TrigNewConversation

Triggers when a user starts a new conversation.

Returns

Body
TrigConversation_Response

When a user is created

Operation ID:
TrigNewUser

Triggers when a new user is created.

Returns

Body
TrigUser_Response

When a user is updated

Operation ID:
TrigUpdateUser

Triggers when an existing user's information is updated.

Returns

Body
TrigUser_Response

Definitions

TrigUser_Response

Name Path Type Description
Id
 id string

Intercom defined id representing the user.
Created Date-Time
 created_at string

yyyy-MM-ddTHH:mm:ss.fffZ
User Id
 user_id string

Unique identifier you have defined for the user.
Email
 email string

User's email.
Phone
 phone string

User's phone number.
Name
 name string

User's name.
Session Count
 session_count integer

Number of sessions the user has recorded.
Image URL
 avatar.image_url string

An avatar image URL, needs to be https.
Is Unsubscribed
 unsubscribed_from_emails boolean

True if the user is unsubscribed from emails.
City Name
 location_data.city_name string

Location of the user.
Country Name
 location_data.country_name string

Location of the user.
Latitude
 location_data.latitude number

Location of the user.
Longitude
 location_data.longitude number

Location of the user.
Postal Code
 location_data.postal_code string

Location of the user.
Region Name
 location_data.region_name string

Location of the user.
Time Zone
 location_data.timezone string

ISO 8601 time zone for the user's location.
Pseudonym
 pseudonym string

The pseudonym used if this user was previously a lead.
companies
 companies.companies array of object

companies
Company Name.
 companies.companies.name string

Name of the company.
companies
 tags.companies array of object

tags
Tag Name
 tags.companies.name string

Name of the tag.

TrigLead_Response

Name Path Type Description
Id
 id string

Intercom defined id representing the lead.
Created Date-Time
 created_at string

yyyy-MM-ddTHH:mm:ss.fffZ
User Id
 user_id string

Unique identifier you have defined for the user.
Email
 email string

Lead's email.
Phone
 phone string

Lead's phone number.
Name
 name string

Lead's name.
Image URL
 avatar.image_url string

An avatar image URL, needs to be https.
Is Unsubscribed
 unsubscribed_from_emails boolean

True if the lead is unsubscribed from emails.
City Name
 location_data.city_name string

Location of the lead.
Country Name
 location_data.country_name string

Location of the lead.
Latitude
 location_data.latitude number

Location of the lead.
Longitude
 location_data.longitude number

Location of the lead.
Postal Code
 location_data.postal_code string

Location of the lead.
Region Name
 location_data.region_name string

Location of the lead.
Time Zone
 location_data.timezone string

ISO 8601 time zone for the lead's location.
companies
 companies.companies array of object

companies
Company Name
 companies.companies.name string

Name of the company.
companies
 tags.companies array of object

tags
Tag Name
 tags.companies.name string

Name of the tag.

TrigConversation_Response

Name Path Type Description
Admin Id
 assignee.id string

User the conversation is currently assigned to.
Author Id
 conversation_message.author.id string

Conversation author's id.
Author Type
 conversation_message.author.type string

Type of the author.
Text
 conversation_message.body string

Body of the message.
Subject
 conversation_message.subject string

Conversation subject.
Message URL
 conversation_message.url string

URL of the conversation message.
Created Date Time
 created_at string

yyyy-MM-ddTHH:mm:ss.fffZ
Id
 id string

Conversation id.
Updated Date Time
 updated_at string

yyyy-MM-ddTHH:mm:ss.fffZ
User Id
 user.id string

Id of user the conversation concerns.
User Type
 user.type string

The user type.

ListLeads_Response

Name Path Type Description
Items
 Lead_Response

User_Response

Name Path Type Description
Id
 id string

Intercom defined id representing the user.
Created Date-Time
 created_at string

yyyy-MM-ddTHH:mm:ss.fffZ
User Id
 user_id string

Unique identifier you have defined for the user.
Email
 email string

User's email.
Phone
 phone string

User's phone number.
Name
 name string

User's name.
Session Count
 session_count integer

Number of sessions the user has recorded.
Image URL
 avatar.image_url string

An avatar image URL, needs to be https.
Is Unsubscribed
 unsubscribed_from_emails boolean

An avatar image URL, needs to be https.
City Name
 location_data.city_name string

Location of the user.
Country Name
 location_data.country_name string

Location of the user.
Latitude
 location_data.latitude number

Location of the user.
Longitude
 location_data.longitude number

Location of the user.
Postal Code
 location_data.postal_code string

Location of the user.
Region Name
 location_data.region_name string

Location of the user.
Time Zone
 location_data.timezone string

ISO 8601 time zone for the user's location.
Pseudonym
 pseudonym string

The pseudonym used if this user was previously a lead.

Lead_Response

Name Path Type Description
Id
 id string

Intercom defined id representing the lead.
Created Date-Time
 created_at string

yyyy-MM-ddTHH:mm:ss.fffZ
Lead Id
 user_id string

Unique identifier you have defined for the lead.
Email
 email string

Lead's email.
Phone
 phone string

Lead's phone number.
Name
 name string

Lead's name.
Image URL
 avatar.image_url string

An avatar image URL, needs to be https.
Is Unsubscribed
 unsubscribed_from_emails boolean

An avatar image URL, needs to be https.
City Name
 location_data.city_name string

Location of the lead.
Country Name
 location_data.country_name string

Location of the lead.
Latitude
 location_data.latitude number

Location of the lead.
Longitude
 location_data.longitude number

Location of the lead.
Postal Code
 location_data.postal_code string

Location of the lead.
Region Name
 location_data.region_name string

Location of the lead.
Time Zone
 location_data.timezone string

ISO 8601 time zone for the lead's location.