Create or update a contact by identifier
/workspaces/{workspaceId}/contacts/identifiers/{identifierKey}//{identifierValue}
Your workspace identifier.
b4e02c85-c6d2-4b15-8885-e09671799c61
The identifier key of you contact.
emailaddress
The identifier value of your identifier key.
contacts@bird.com
A map of key-value pairs, where the values are boolean, number, or string, or a non-empty array of those, or null
{"firstName":"John","lastName":"Smith","rating":9.6,"cookiesAccepted":false,"labels":["A","B","C"]}
Examples
Let's establish some of our data that will be used in the following examples:
Workspace ID: a1405560-c8d3-4b1a-877d-3f449ad95352
AccessKey: abcd
Contact ID: 12bd0e40-9361-4e32-8b26-99b4ab7eae09
Update contact's identifiers
In this example, we're updating a contact providing identifiers. To know more about identifiers, please refer to this documentation.
Update contact's attributes
In this example, we're updating a contact providing attributes. To know more about attributes, please refer to this documentation.
Create a new contact
In this example, we're creating a new contact because the provided identifier is not being used by any existing contacts.
Last updated
Was this helpful?