The intercom API reference.
The intercom API reference.
Data Attributes are metadata used to describe your contact, company and conversation models. These include standard and custom attributes. By using the data attributes endpoint, you can get the global list of attributes for your workspace, as well as create and archive custom attributes.
The unique identifier for the data attribute which is given by Intercom. Only available for custom attributes.
12878
Value is contact
for user/lead attributes and company
for company attributes.
"contact"
Full name of the attribute. Should match the name unless it's a nested attribute. We can split full_name on .
to access nested user object values.
"custom_attributes.paid_subscriber"
Readable description of the attribute.
"Whether the user is a paid subscriber."
The data type of the attribute.
"boolean"
The time the attribute was created as a UTC Unix timestamp
1671028894
The time the attribute was last updated as a UTC Unix timestamp
1671028894
{ "type": "data_attribute", "id": 12878, "model": "contact", "name": "paid_subscriber", "full_name": "custom_attributes.paid_subscriber", "label": "Paid Subscriber", "description": "Whether the user is a paid subscriber.", "data_type": "boolean", "options": [ "true", "false" ], "api_writable": true, "messenger_writable": false, "ui_writable": true, "custom": true, "archived": false, "created_at": 1671028894, "updated_at": 1671028894, "admin_id": "5712945" }
curl -i -X GET \ 'https://api.intercom.io/data_attributes?include_archived=true&model=contact' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.11'
{ "type": "list", "data": [ { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … } ] }
The model that the data attribute belongs to.
"contact"
The type of data stored for this attribute.
"string"
The readable description you see in the UI for the attribute.
"My Data Attribute Description"
To create list attributes. Provide a set of hashes with value
as the key of the options you want to make. data_type
must be string
.
["option1","option2"]
curl -i -X POST \ https://api.intercom.io/data_attributes \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -H 'Intercom-Version: 2.11' \ -d '{ "name": "Mithril Shirt", "model": "company", "data_type": "string" }'
Successful
The unique identifier for the data attribute which is given by Intercom. Only available for custom attributes.
12878
Value is contact
for user/lead attributes and company
for company attributes.
"contact"
Full name of the attribute. Should match the name unless it's a nested attribute. We can split full_name on .
to access nested user object values.
"custom_attributes.paid_subscriber"
Readable description of the attribute.
"Whether the user is a paid subscriber."
The data type of the attribute.
"boolean"
The time the attribute was created as a UTC Unix timestamp
1671028894
The time the attribute was last updated as a UTC Unix timestamp
1671028894
{ "id": 37, "type": "data_attribute", "name": "Mithril Shirt", "full_name": "custom_attributes.Mithril Shirt", "label": "Mithril Shirt", "data_type": "string", "api_writable": true, "ui_writable": false, "messenger_writable": false, "custom": true, "archived": false, "admin_id": "991267686", "created_at": 1719492955, "updated_at": 1719492955, "model": "company" }
The readable description you see in the UI for the attribute.
"My Data Attribute Description"
To create list attributes. Provide a set of hashes with value
as the key of the options you want to make. data_type
must be string
.
["option1","option2"]
curl -i -X PUT \ 'https://api.intercom.io/data_attributes/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -H 'Intercom-Version: 2.11' \ -d '{ "description": "Just a plain old ring", "options": [ { "value": "1-10" }, { "value": "11-20" } ], "archived": false }'
Successful
The unique identifier for the data attribute which is given by Intercom. Only available for custom attributes.
12878
Value is contact
for user/lead attributes and company
for company attributes.
"contact"
Full name of the attribute. Should match the name unless it's a nested attribute. We can split full_name on .
to access nested user object values.
"custom_attributes.paid_subscriber"
Readable description of the attribute.
"Whether the user is a paid subscriber."
The data type of the attribute.
"boolean"
The time the attribute was created as a UTC Unix timestamp
1671028894
The time the attribute was last updated as a UTC Unix timestamp
1671028894
{ "id": 44, "type": "data_attribute", "name": "The One Ring", "full_name": "custom_attributes.The One Ring", "label": "The One Ring", "description": "Just a plain old ring", "data_type": "string", "options": [ "1-10", "11-20" ], "api_writable": true, "ui_writable": false, "messenger_writable": true, "custom": true, "archived": false, "admin_id": "991267693", "created_at": 1719492958, "updated_at": 1719492959, "model": "company" }