Channelsv4

Remove (unsubscribe) a Blooio number

DELETE/channels/{channel}

Removes/unsubscribes an owned Blooio line, cancelling its subscription — the same flow as the dashboard unsubscribe button. Accepts either the E.164 number or the ch_ channel id as {channel}. A reasons array (why the customer is unsubscribing) is required; the same reason handling updates the CRM, posts to Slack, and emits a number.removed webhook. Requires the numbers:manage scope for OAuth apps.

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

reasonsRequiredstring[]

One or more churn reason codes/labels for the removal.

Returns

dataoptionalobject

phone_numberoptionalstring

channel_idoptionalstring | null

reasonsoptionalstring[]

Response codes

200The line was removed.

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`.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X DELETE https://api.blooio.com/v4/channels/string \

  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "reasons": [      "too_expensive",      "no_longer_needed"    ]  }'

Body object

{  "reasons": [    "too_expensive",    "no_longer_needed"  ]}

Response objectexample

{  "data": {    "phone_number": "+15551234567",    "channel_id": "ch_a1b2c3d4",    "reasons": [      "string"    ]  }}