Contactsv4

Attach an identity

POST/contacts/{contactId}/identities

Attaches a phone/email identity (on a channel type) to a contact.

Path parameters

contactIdRequiredstring

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

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

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

channel_idoptionalstring

Required when channel_type is amb.

Returns

dataoptionalContactIdentity

idoptionalstring

Identity id (cid_...).

contact_idoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

identifieroptionalstring

Phone (E.164) or email.

channel_idoptionalstring | null

Required for AMB identities.

created_atoptionalinteger

Response codes

201Attached identity

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 POST https://api.blooio.com/v4/contacts/ct_a1b2c3d4/identities \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "identifier": "+15551234567",    "channel_type": "blooio",    "channel_id": "ch_a1b2c3d4"  }'

Body object

{  "identifier": "+15551234567",  "channel_type": "blooio",  "channel_id": "ch_a1b2c3d4"}

Response objectexample

{  "data": {    "id": "obj_a1b2c3d4",    "contact_id": "ct_a1b2c3d4",    "channel_type": "blooio",    "identifier": "+15551234567",    "channel_id": "ch_a1b2c3d4",    "created_at": 0  }}