Update channel settings
/channels/{channel}/settingsPartial 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; imessage_only is available on every line. Apple Messages for Business and WhatsApp Business: opener, a partial update of the channel's opener (send only the fields you want to change). Turning a setting OFF is always allowed. Errors return a machine-readable code: settings_unsupported_for_channel_type (403, a channel type without settings), 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 field, a value of the wrong type, or an opener turned on without its template), invalid_invitation (422, an AMB opener template missing a required parameter), template_not_approved (422, a WhatsApp opener template that isn't approved on this channel). A malformed channel selector or non-object body is 400.
Path parameters
channelRequiredstringThe 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
AuthorizationRequiredstringYour API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.
Body parameters
JSONauto_mark_readoptionalbooleanBlooio: mark a chat read on the device as soon as a message arrives. Dedicated + inbound lines only.
imessage_onlyoptionalbooleanBlooio: a routed send (POST /messages without from) starts a conversation on this line only with a contact on iMessage, checked on the line's device; a contact who isn't, or a device that can't answer, moves the send to the next channel in the priority. Conversations the line already has are unaffected. Off by default, when the device sends SMS to a contact without iMessage.
openeroptionalAmbOpener | WhatsAppOpenerApple Messages for Business or WhatsApp Business: a partial update of the channel's opener, merged into the saved one. Turning it on validates the template.
openeroptionalAmbOpener | WhatsAppOpenerApple Messages for Business or WhatsApp Business: a partial update of the channel's opener, merged into the saved one. Turning it on validates the template.
enabledoptionalbooleantemplate_idoptionalstring | nullparametersoptionalobject | nullTemplate parameters. An image parameter such as brandLogo may be an https URL; it is inlined when the invitation is sent.
localeoptionalstring | nullReturns
dataoptionalChannelSettingsPer-channel settings envelope. settings and available shapes vary by channel type: Blooio (P2P numbers) exposes auto_mark_read, auto_share_contact, and imessage_only; Apple Messages for Business and WhatsApp Business expose opener (AmbOpener, WhatsAppOpener). available[key] is whether THIS channel may turn key on (type-gated).
dataoptionalChannelSettingsPer-channel settings envelope. settings and available shapes vary by channel type: Blooio (P2P numbers) exposes auto_mark_read, auto_share_contact, and imessage_only; Apple Messages for Business and WhatsApp Business expose opener (AmbOpener, WhatsAppOpener). available[key] is whether THIS channel may turn key on (type-gated).
channel_idoptionalstringChannel id (ch_...).
typeoptionalstring"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"settingsoptionalobjectCurrent setting values for this channel (keys are per channel type).
availableoptionalobjectWhether this channel may turn each setting on (type-gated).
Response codes
Sends a live request with your values and shows the real response below. Your key is stored only in this browser.
curl -X PATCH https://api.blooio.com/v4/channels/string/settings \{ "data": { "channel_id": "ch_a1b2c3d4", "type": "blooio", "settings": { "auto_mark_read": false, "auto_share_contact": false, "imessage_only": false }, "available": { "auto_mark_read": true, "auto_share_contact": true, "imessage_only": true } }}