Skip to content
Home/
REST API Reference
/
/
Update Contact Request Pa...

Update Contact Request Payload

You can update a contact

rolestring

The role of the contact, either user or lead. Any other value is ignored. A user can't be changed to a lead; sending lead for a user returns a 400 error.

external_idstring

A unique identifier for the contact which is given to Intercom

emailstring

The contacts email

Example:"jdoe@example.com"
email_verifiedboolean or null

Whether the contact has proved they own this email address, for example through a confirmation link or one-time code you sent. Send it together with email. email_verified without email is rejected.

Changing a contact's email resets it to not verified. Intercom reuses leads with a verified email when an inbound email, conversation or ticket matches the address.

Example:true
phonestring or null

The contacts phone

Example:"+353871234567"
namestring or null

The contacts name

Example:"John Doe"
avatarstring or null

An image URL containing the avatar of a contact

Example:"https://www.example.com/avatar_image.jpg"
signed_up_atinteger or null, (date-time)

(Unix timestamp in seconds) The time specified for when a contact signed up.

Example:1571672154
last_seen_atinteger or null, (date-time)

(Unix timestamp in seconds) The time when the contact was last seen (either where the Intercom Messenger was installed or when specified manually).

Example:1571672154
owner_idstring or null

The id of an admin that has been assigned account ownership of the contact

Example:"321"
unsubscribed_from_emailsboolean or null

Whether the contact is unsubscribed from emails

Example:true
unsubscribed_from_smsboolean

Whether the contact is unsubscribed from SMS messages.

Example:false
language_overridestring or null

A preferred language setting for the contact, used by the Intercom Messenger even if their browser settings change.

Example:"en"
custom_attributesobject or null

The custom attributes which are set for the contact

{
  "role": "string",
  "external_id": "string",
  "email": "jdoe@example.com",
  "email_verified": true,
  "phone": "+353871234567",
  "name": "John Doe",
  "avatar": "https://www.example.com/avatar_image.jpg",
  "signed_up_at": 1571672154,
  "last_seen_at": 1571672154,
  "owner_id": "321",
  "unsubscribed_from_emails": true,
  "sms_consent": false,
  "unsubscribed_from_sms": false,
  "language_override": "en",
  "custom_attributes": {}
}