The intercom API reference.
Intercom API (2.10)
Download OpenAPI description
Overview
URL
License
Languages
Servers
The production API server
https://api.intercom.io/
The european API server
https://api.eu.intercom.io/
The australian API server
https://api.au.intercom.io/
Update Contact Request Payload
You can update a contact
An image URL containing the avatar of a contact
Example: "https://www.example.com/avatar_image.jpg"
The time specified for when a contact signed up
Example: 1571672154
The time when the contact was last seen (either where the Intercom Messenger was installed or when specified manually)
Example: 1571672154
The id of an admin that has been assigned account ownership of the contact
Example: 123
Whether the contact is unsubscribed from emails
Example: true
{ "role": "string", "external_id": "string", "email": "jdoe@example.com", "phone": "+353871234567", "name": "John Doe", "avatar": "https://www.example.com/avatar_image.jpg", "signed_up_at": 1571672154, "last_seen_at": 1571672154, "owner_id": 123, "unsubscribed_from_emails": true, "custom_attributes": {} }
Update Data Attribute Request
One of:
Array of objects representing the options of the list, with value as the key and the option as the value. At least two options are required.
Example: [{"value":"1-10"},{"value":"11-50"}]
The readable description you see in the UI for the attribute.
Example: "My Data Attribute Description"
{ "options": [ { … }, { … } ], "archived": false, "description": "My Data Attribute Description", "messenger_writable": false }