Docs
BetaThe V4 API is in beta — endpoints and functionality may change.
Contactsv4

Update an identity

PATCH/contacts/{contactId}/identities/{identityId}

Renames a contact identity in place. An optional name updates the parent contact in the same request.

Path parameters

contactIdRequiredstring

Unique identifier of the contact, prefixed with ct_. Returned when you create a contact or by the List contacts endpoint.

identityIdRequiredstring

Unique identifier of the contact identity, prefixed with cid_.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON
identifierRequiredstring
nameoptionalstring | null

Returns

dataoptionalContactIdentity
idoptionalstring

Identity id (cid_...).

contact_idoptionalstring
channel_typeoptionalstring
"blooio""twilio""whatsapp""whatsapp_business""rcs_business"
identifieroptionalstring

Phone (E.164) or email.

channel_idoptionalstring | null

Reserved for future use.

created_atoptionalinteger

Response codes

200Updated identity
400The request was malformed — check the path, query parameters, and body.
401Your API key is missing or invalid. Pass it as a bearer token.
404No contact was found with the provided `contactId`.
409The request conflicts with the current state of the contact (e.g. it already exists, the chat is closed, or the channel isn't active).
422Validation failed — one or more fields in the request are invalid or missing.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X PATCH https://api.blooio.com/v4/contacts/ct_a1b2c3d4/identities/idn_a1b2c3d4 \
Body object
Response objectexample
{  "data": {    "id": "obj_a1b2c3d4",    "contact_id": "ct_a1b2c3d4",    "channel_type": "blooio",    "identifier": "+15551234567",    "channel_id": "ch_a1b2c3d4",    "created_at": 0  }}