Chatsv4

Find or create a chat

POST/chats

Finds or creates a 1:1 chat with a recipient on a channel. Returns the chat (with created indicating whether it was newly created).

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

channel_idRequiredstring

toRequiredobject

identifierRequiredstring

Returns

idoptionalstring

channel_idoptionalstring

channel_typeoptionalstring

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

contact_idoptionalstring | null

identity_idoptionalstring | null

stateoptionalstring

"open""closed""blocked""deprecated"

createdoptionalboolean

True if the chat was newly created.

Response codes

200Existing chat

201Created chat

401Your API key is missing or invalid. Pass it as a bearer token.

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/chats \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "channel_id": "ch_a1b2c3d4",    "to": {      "identifier": "+15551234567"    }  }'

Body object

{  "channel_id": "ch_a1b2c3d4",  "to": {    "identifier": "+15551234567"  }}

Response objectexample

{  "id": "obj_a1b2c3d4",  "channel_id": "ch_a1b2c3d4",  "channel_type": "blooio",  "contact_id": "ct_a1b2c3d4",  "identity_id": "idn_a1b2c3d4",  "state": "open",  "created": false}