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.

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's email address has been verified. Set to true to indicate you have verified the contact owns this email address, or false to mark it as unverified. Must be supplied together with an email in the same request; sending it without an email returns a 400.

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
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,
  "custom_attributes": {}
}