Docs
Channelsv4

Update channel profile

PUT/channels/{channel}/profile

Partial update of the channel profile (display_name, about, email, avatar). Stored under metadata.profile and returned on GET /channels/{channel}. Null or empty string clears a field. Unknown keys are rejected. This writes Blooio metadata only; it does not push a display name to the device.

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
display_nameoptionalstring | null
aboutoptionalstring | null
emailoptionalstring | null
avataroptionalstring | null

Returns

dataoptionalChannel
idoptionalstring

Channel id (ch_...).

typeoptionalstring
"blooio""twilio""whatsapp""whatsapp_business""rcs_business"
addressoptionalstring | null

The channel's real address: the phone number for numbered channels, or the provider address for non-numbered ones. Usable directly as from.

aliasoptionalstring

Movable, organization-wide name for a non-numbered channel (currently RCS Business). Usable directly as from. Omitted for numbered channels.

statusoptionalstring
"pending_verification""active""suspended""banned""deprecated"
capabilitiesoptionalChannelCapabilities

What a channel can do. Shape varies by channel type.

protocolsoptionalstring[]
contentoptionalstring[]
actionsoptionalstring[]
interactiveoptionalstring[]
gatesoptionalstring[]
profileoptionalChannelProfile

Stored channel profile. Omitted on GET when no fields are set. Null or empty string on PUT clears a field.

display_nameoptionalstring | null
aboutoptionalstring | null
emailoptionalstring | null
avataroptionalstring | null
settingsoptionalobject

Inline per-channel settings for channel types that support them (currently Blooio numbers). Each setting value plus a can_<key> flag for whether this channel may enable it. Omitted for channel types without settings. Full read/write via GET/PATCH /channels/{channel}/settings.

created_atoptionalinteger

Epoch milliseconds.

Response codes

200Updated channel, including `profile`
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 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 PUT https://api.blooio.com/v4/channels/string/profile \
Body object
Response objectexample
{  "data": {    "id": "ch_a1b2c3d4",    "type": "blooio",    "address": "123 Main St",    "alias": "string",    "status": "pending_verification",    "capabilities": {      "protocols": [        "string"      ],      "content": [        "Hello from Blooio!"      ],      "actions": [        "string"      ],      "interactive": [        "string"      ],      "gates": [        "string"      ]    },    "profile": {      "display_name": "Jane Doe",      "about": "string",      "email": "jane@example.com",      "avatar": "https://example.com/image.jpg"    },    "settings": {      "auto_mark_read": false,      "auto_share_contact": false,      "can_auto_mark_read": true,      "can_auto_share_contact": true    },    "created_at": 0  }}