Docs
Accountv4

Request call forwarding

POST/me/numbers/{number}/call-forwarding

Opens a support ticket to forward calls from an owned dedicated or inbound Blooio number. The destination must be a US E.164 number. Shared or foreign source numbers are rejected. Forwarding isn't instant: check its progress with GET /tickets/{ticket_id} using the returned ticket_id, whose forwarding.state reaches completed when calls forward. OAuth apps need numbers:manage to open the request and tickets:read to check it.

Path parameters

numberRequiredstring

Sender phone number in E.164 format, e.g. +15551234567.

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
forward_toRequiredstring

US E.164 number to forward calls to.

Returns

dataoptionalobject
successoptionalboolean
ticket_idoptionalstring

Pass to GET /tickets/{ticket_id} to check progress.

statusoptionalstring

open: not picked up yet. in_progress: Blooio support is working on it. waiting_on_customer: support needs a reply from you. closed: resolved.

"open""in_progress""waiting_on_customer""closed"
numberoptionalstring

E.164 source number.

forward_tooptionalstring

E.164 destination number.

Response codes

201Call forwarding requested
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this account (blocked key or plan limit).
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/me/numbers/%2B15551234567/call-forwarding \
Body object
Response objectexample
{  "data": {    "success": false,    "ticket_id": "obj_a1b2c3d4",    "status": "open",    "number": "+15551234567",    "forward_to": "string"  }}