# Intercom - Create or update users action

The Create or update users action allows you to create new users or update existing users in Intercom based on an email or user ID that you search for. If a user is not found, the action creates a new user. Otherwise, it updates the user's details.

Create users actionIntercom - Create or update users action

# Input

  • Parallel

  • Specify the number of parallel requests to perform. Set a value between 1 and 10.

  • Requests per minute

  • Set the target request rate per minute. The rate is calculated on a 10-second interval basis. For detailed rate limits, refer to the Intercom API rate limit documentation (opens new window). Setting this field to zero, or leaving it empty, removes rate limiting.

  • Users

  • Provide user details either directly or from a list.

    • Users source list

    • Input a list datapill if you are sourcing from a list input.

    • User ID

    • Enter the unique identifier for the user within Intercom.

    • Name

    • Input the user's full name.

    • Email

    • Provide the user's email address.

    • Unsubscribed from emails

    • Indicates whether the user has opted out of email communication.

    • Intercom ID of company

    • Enter the Intercom ID for the company associated with the user.

    • Company ID

    • Input the company's unique identifier.

    • Company name

    • Provide the company's name.

    • Company monthly spend

    • Enter the monthly spend associated with the company.

    • Custom attributes

    • Include any custom attributes for the user as necessary.

# Output

Successful
Contains details of users successfully created or updated.
Type
The type of entity.
ID
The unique identifier for the user.
User ID
The identifier assigned to the user within Intercom.
Anonymous
Indicates if the user is anonymous.
Email
The email address of the user.
Name
The full name of the user.
Avatar
The avatar details of the user.
Type
The type of avatar.
Image URL
The URL link to the user's avatar image.
App ID
The identifier of the application within Intercom.
Companies
List of companies associated with the user.
Type
The type of associated entities.
Companies
The companies connected to the user.
Type
The type of company data.
Company ID
The unique identifier of the company.
ID
The unique identifier used within Intercom for the company.
Company name
The name of the company.
List size
The number of companies associated with the user.
List index
The index of the company in the associated list.
Location data
Contains geographic information about the user.
Type
The type of location data provided.
City name
The city associated with the user's location.
Continent code
The continent code for the user's location.
Country name
The country name for the user's location.
Latitude
The latitude coordinate for the user's location.
Longitude
The longitude coordinate for the user's location.
Postal code
The postal code for the user's location.
Region name
The region name for the user's location.
Timezone
The timezone for the user's location.
Country code
The country code for the user's location.
Phone
The phone number associated with the user.
Pseudonym
The pseudonym, if any, used by the user.
Remote created at
The timestamp of when the user was created remotely.
Session Count
The number of sessions the user has logged.
Owner ID
The identifier of the user who owns the account within Intercom.
Last request at
The timestamp of the last request made by the user.
Created at
The timestamp of when the user was created in Intercom.
Signed up at
The timestamp of when the user signed up.
Updated at
The timestamp of when the user's information was last updated.
Unsubscribed from emails
Indicates whether the user has unsubscribed from emails.
Marked email as spam
Indicates whether the user has marked an email as spam.
Has hard bounced
Indicates whether an email sent to the user has hard bounced.
Do not track
Indicates whether the user has enabled do not track.
Referrer
The referrer URL through which the user was acquired.
Last Seen IP
The last known IP address of the user.
User Agent Data
Information about the user's browser and operating system.
Utm campaign
The UTM campaign associated with the user.
Utm content
The UTM content parameter associated with the user.
Utm medium
The UTM medium parameter associated with the user.
Utm source
The UTM source parameter associated with the user.
Utm term
The UTM term parameter associated with the user.
Social profiles
Contains information about the social profiles linked to the user.
Type
The type of social profile information.
Social profiles
Detailed list of social profiles.
ID
The unique identifier for each social profile.
Name
The name of the social network.
Type
The type of the social network.
URL
The URL of the user's profile on the social network.
Username
The username of the user on the social network.
List size
The total number of social profiles associated with the user.
List index
The index of the social profile within the list.
Custom attributes
Custom data attributes associated with the user.
Tags list
A list of tags applied to the user.
Tags
Detailed information about the tags.
Sync
Indicates the synchronization status of the tags.
Segments list
A list of segments the user is part of.
Segments
Detailed information about the segments.
Active
Indicates if the segment is currently active.
New
Indicates if it is a new segment for the user.
Slipping Away
Indicates if the user is slipping away from the segment.
List size
The total number of records processed in the batch.
List index
The index of the current record in the batch.
Failed
Contains information about users that failed to create or update.
User
The user information for the failed action.
User ID
The unique identifier of the user within Intercom.
Email
The email address associated with the user.
Error
The error message associated with the failed action.
List size
The total number of failed records.
List index
The index of the current failed record within the list of all failed records.
All records in batch succeeded?
Indicates whether all records in the batch were successfully processed.
Number of records succeeded
The count of records that were successfully processed.
Number of records failed
The count of records that failed to process.


Last updated: 4/22/2024, 5:48:05 PM

On this page