Intercom
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 |
|---|---|---|
| Copilot Studio | 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) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - 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) |
| 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) |
| 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
Creates a new lead for your Intercom account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
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
Creates a new user for your Intercom account. Users found via email will be updated.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Email
|
True | string | ||
|
Name
|
name | string | ||
|
Phone
|
phone | string | ||
|
Company Id
|
companies | string |
Returns
- Body
- User_Response
Get lead
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
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
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
When a new conversation starts
When a user is created
When a user is updated
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
|
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
|
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
|
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
|
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. |