Updates or adds custom attributes to an existing contact. Attributes are merged with existing ones.
Polymorphic ID formats
- Numeric ID:
29911301 - Custom User ID:
cuid:user_123 - Custom Lead ID:
clid:lead_456 - User Email:
uem:[email protected] - Lead Email:
lem:[email protected] - WhatsApp:
wa:+1234567890
Behavior
- Attributes are merged incrementally (only specified attributes are updated)
- Existing attributes not included in the request remain unchanged
Response Data
The endpoint returns the complete contact object including:
- All contact basic information (name, email, role, etc.)
- All attributes (both updated and unchanged ones)
- All tags associated with the contact
- Custom contact ID, WhatsApp number, and other identifiers
Further Reading
Contact properties can be powerful tools in managing and understanding your customer base.
For a detailed guide on how to utilize contact properties within Customerly, including creating
custom properties and managing default ones, refer to:
A Complete Guide About Contact Properties
This guide provides step-by-step instructions and best practices for working with contact
properties in your Customerly account.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Authentication credentials are missing or invalid
You don't have permission to update this contact
Contact not found
Validation error. Possible causes: attributes must be an object, attribute names contain invalid characters (only alphanumeric, underscores, and hyphens allowed), or attribute values are arrays/objects (only simple types allowed: strings, numbers, booleans).