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

Update channel settings

PATCH/channels/{channel}/settings

Partial update of a channel's settings (send only the keys you want to change). Keys are per channel type. Blooio (P2P numbers): auto_mark_read is available on dedicated and inbound lines; auto_share_contact is dedicated-only AND the line must have a contact card (name or photo) set up. Turning a setting OFF is always allowed. Errors return a machine-readable code: settings_unsupported_for_channel_type (403, non-Blooio channel), auto_mark_read_not_allowed / auto_share_contact_not_allowed (403, line type can't enable it), contact_card_not_set_up (403, enable auto_share_contact with no contact card), no_settings_provided (422, empty update), invalid_settings (422, unknown key or non-boolean value). A malformed channel selector or non-object body is 400.

Path parameters

channelRequiredstring

The channel reference — the same three forms from accepts: a phone number (URL-encode + as %2B), a channel alias, or the exact channel id (ch_...).

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
auto_mark_readoptionalboolean

Blooio: mark a chat read on the device as soon as a message arrives. Dedicated + inbound lines only.

auto_share_contactoptionalboolean

Blooio: share the number's Name & Photo card with people who message it. Dedicated lines only, and the line must have a contact card set up.

Returns

dataoptionalChannelSettings

Per-channel settings envelope. settings and available shapes vary by channel type; the Blooio (P2P numbers) provider exposes auto_mark_read and auto_share_contact. available[key] is whether THIS channel may turn key on (type-gated).

channel_idoptionalstring

Channel id (ch_...).

typeoptionalstring
"blooio""twilio""whatsapp""whatsapp_business""rcs_business"
settingsoptionalobject

Current setting values for this channel (keys are per channel type).

availableoptionalobject

Whether this channel may turn each setting on (type-gated).

Response codes

200Updated channel settings
400The request was malformed — check the path, query parameters, and body.
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this channel (blocked key or plan limit).
404No channel was found with the provided `channel`.
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/channels/string/settings \
Body object
Response objectexample
{  "data": {    "channel_id": "ch_a1b2c3d4",    "type": "blooio",    "settings": {      "auto_mark_read": false,      "auto_share_contact": false    },    "available": {      "auto_mark_read": true,      "auto_share_contact": true    }  }}