Update a contact
Update the specified contact given its ID. This endpoint allows you to update the contact's attributes, lists, and identifiers.
Your workspace identifier.
b4e02c85-c6d2-4b15-8885-e09671799c61
The ID of a contact.
b4e02c85-c6d2-4b15-8885-e09671799c61
The set of attribute keys to return for the contact besides all non-empty attributes.
["age","company"]
The list of list ids to add the contact to.
123e4567-e89b-12d3-a456-426614174000
The list of list ids to remove the contact from.
123e4567-e89b-12d3-a456-426614174000
The list of list ids for the contact.
123e4567-e89b-12d3-a456-426614174000
The list of account ids to add the contact to.
123e4567-e89b-12d3-a456-426614174000
The list of account ids to remove the contact from.
123e4567-e89b-12d3-a456-426614174000
The list of account ids for the contact.
123e4567-e89b-12d3-a456-426614174000
PATCH /workspaces/{workspaceId}/contacts/{contactId} HTTP/1.1
Host: api.bird.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 718
{
"attributes": {
"firstName": "John",
"lastName": "Smith",
"rating": 9.6,
"cookiesAccepted": false,
"labels": [
"A",
"B",
"C"
]
},
"addIdentifiers": [
{
"key": "secondaryEmailAddress",
"value": "[email protected]",
"properties": {
"countryCode": "US",
"isGmail": true
}
}
],
"removeIdentifiers": [
{
"key": "secondaryEmailAddress",
"value": "[email protected]"
}
],
"addToLists": [
"123e4567-e89b-12d3-a456-426614174000"
],
"removeFromLists": [
"123e4567-e89b-12d3-a456-426614174000"
],
"listIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"addToAccounts": [
"123e4567-e89b-12d3-a456-426614174000"
],
"removeFromAccounts": [
"123e4567-e89b-12d3-a456-426614174000"
],
"accountIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"ANY_ADDITIONAL_PROPERTY": "anything"
}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"computedDisplayName": "John Doe",
"createdAt": "2025-06-22T18:56:20.385Z",
"updatedAt": "2025-06-22T18:56:20.385Z",
"workspaceId": "123e4567-e89b-12d3-a456-426614174000",
"featuredIdentifiers": [
{
"key": "emailaddress",
"value": "[email protected]"
}
],
"attributes": {
"firstName": "John",
"lastName": "Smith",
"rating": 9.6,
"cookiesAccepted": false,
"labels": [
"A",
"B",
"C"
]
},
"identifierCount": 2,
"accountIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"listIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
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.
curl -X PATCH "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/contacts/12bd0e40-9361-4e32-8b26-99b4ab7eae09" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd" \
-d '{
"addIdentifiers": [
{
"key": "emailaddress",
"value": "[email protected]"
}
]
}'
Update contact's attributes
In this example, we're updating a contact providing attributes. To know more about attributes, please refer to this documentation.
curl -X PATCH "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/contacts/12bd0e40-9361-4e32-8b26-99b4ab7eae09" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd" \
-d '{
"attributes": {
"countryCode": "US"
}
}'
Update contact's lists
In this example, we're updating a contact providing list IDs. To knoe more about lists, please refer to this documentation.
curl -X PATCH "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/contacts/12bd0e40-9361-4e32-8b26-99b4ab7eae09" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd" \
-d '{
"addToLists": ["12bd0e40-9361-4e32-8b26-99b4ab7eae09"]
}'
Update contact's details
In this example, we're creating a contact providing all the examples above.
curl -X PATCH "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/contacts/12bd0e40-9361-4e32-8b26-99b4ab7eae09" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd" \
-d '{
"addToLists": [
"12bd0e40-9361-4e32-8b26-99b4ab7eae09"
],
"attributes": {
"countryCode": "US"
},
"addIdentifiers": [
{
"key": "emailaddress",
"value": "[email protected]"
}
]
}'
Last updated
Was this helpful?