# 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.
Intercom - 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.
- 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.
- 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