Docs
Ticketsv4

Open a ticket

POST/tickets

Opens a support ticket for the Blooio team. Every ticket opens at medium priority; only Blooio support changes it, so sending priority returns 422 priority_not_allowed. To request call forwarding, prefer POST /me/numbers/{number}/call-forwarding, which takes the destination as a field. OAuth apps need tickets:write.

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
typeRequiredstring
"support""billing""technical""feature_request""call_forwarding"
contentRequiredstring

What you need. A call_forwarding ticket must read Please forward <source> to <destination> with two US numbers.

Returns

dataoptionalTicket
idoptionalstring

Ticket id (tkt_...).

typeoptionalstring
"purchase""purchase_failure""support""billing""technical""feature_request""call_forwarding""system"
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"
priorityoptionalstring

Read-only. Tickets open at medium; only Blooio support changes it.

"low""medium""high""urgent"
contentoptionalstring | null

The request as it was opened.

forwardingoptionalTicketForwarding | null

Progress of a call_forwarding ticket; null for every other type.

TicketForwarding
stateoptionalstring

pending: not started yet. in_progress: Blooio is setting up forwarding with the carrier. completed: calls now forward. failed: the last attempt failed, and the ticket stays open with Blooio support. A closed ticket always reads completed.

"pending""in_progress""completed""failed"
source_numberoptionalstring | null

E.164 number whose calls are forwarded.

destination_numberoptionalstring | null

E.164 number calls are forwarded to.

completed_atoptionalinteger | null

When forwarding completed; for a ticket closed without a recorded completion, when it was closed. null until state is completed.

null
can_commentoptionalboolean

Whether this ticket type takes replies. A closed ticket also refuses them.

created_atoptionalinteger
updated_atoptionalinteger

Response codes

201Ticket opened
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 ticket (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/tickets \
Body object
Response objectexample
{  "data": {    "id": "obj_a1b2c3d4",    "type": "purchase",    "status": "open",    "priority": "low",    "content": "Hello from Blooio!",    "forwarding": {      "state": "pending",      "source_number": "string",      "destination_number": "string",      "completed_at": 0    },    "can_comment": false,    "created_at": 0,    "updated_at": 0  }}