Prioritiesv4

Create a priority

POST/priorities

Creates a channel priority. Channels sharing a priority (and type) form a pool; ascending priority is the send-time waterfall. The first priority created for a key becomes its default unless is_default: false is set.

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

nameoptionalstring

is_defaultoptionalboolean

Make this the key's default priority. Defaults to true for the key's first priority.

channelsRequiredstring | object[]

Channels in the priority. Each item is a channel id string or { channel_id, priority }. Channels sharing a priority must be the same type.

Array of string | object

string

object

channel_idRequiredstring

priorityoptionalinteger

Returns

dataoptionalPriority

idoptionalstring

Priority id (priority_...).

nameoptionalstring | null

is_defaultoptionalboolean

Whether this is the key's default priority (used by the agnostic send).

channelsoptionalPriorityChannel[]

Array of PriorityChannel

channel_idRequiredstring

Channel id (ch_...).

typeoptionalstring

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

priorityRequiredinteger

Tier (drag order). Lower runs first; same priority + same type = a pool.

created_atoptionalinteger

updated_atoptionalinteger

Response codes

201Created priority

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 prioritie was found.

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/priorities \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "name": "Jane Doe",    "is_default": true,    "channels": [      "string"    ]  }'

Body object

{  "name": "Jane Doe",  "is_default": true,  "channels": [    "string"  ]}

Response objectexample

{  "data": {    "id": "obj_a1b2c3d4",    "name": "Jane Doe",    "is_default": true,    "channels": [      {        "channel_id": "ch_a1b2c3d4",        "type": "blooio",        "priority": 1      }    ],    "created_at": 0,    "updated_at": 0  }}