Skip to Content
My App
Api

Broadcast

Send the same message to many contacts at once and track each broadcast's progress and per-recipient delivery.

GET
/broadcasts

Authorization

http
headerAuthorizationBearer <token>

Query Parameters

status?string

Response Body

application/json
  1. response
data*array<string>
meta*
Example Request
curl -X GET 'https://aexrux.com/api/v1/broadcasts'
Example Response200
{  "data": [    "string"  ],  "meta": {    "count": 0  }}
POST
/broadcasts

Authorization

http
headerAuthorizationBearer <token>

Request Body

application/json
  1. body

Create a broadcast — send one template to a list of contacts and/or a contact group. Scramble reads these rules to document the request body.

Mirrors the input keys the existing BroadcastsController::store accepts (broadcast_name / template_id / contacts[] / groups[] / device_id / schedule_type+send_date+send_time / timezone), exposed under public-facing names. At least one of recipients or group_id is required; provide schedule_at to schedule for later, omit it to send now.

name*string

Broadcast label shown in the dashboard. Required.

Lengthlength <= 255
template_id*integer

Approved WaTemplate id to send to every recipient. Required.

group_id?|

Contact-group id — every member is added as a recipient.

device_id?|

Sending device id (optional — defaults to the workspace's primary device).

schedule_at?|

When to send — ISO 8601 / parseable datetime. Omit to send immediately.

Lengthlength <= 64
timezone?|

IANA timezone for schedule_at (e.g. Asia/Kolkata). Defaults to UTC.

Lengthlength <= 64
recipients?array<integer>|

Recipient contact ids. Required unless group_id is given.

Response Body

application/json
  1. response
data*array<unknown>
meta*
Example Request
curl -X POST 'https://aexrux.com/api/v1/broadcasts' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "template_id": 0}'
Example Response
{  "data": [    null  ],  "meta": {    "broadcast_ids": "string",    "devices_count": "string"  }}
GET
/broadcasts/{id}

Authorization

http
headerAuthorizationBearer <token>

Path Parameters

id*integer

Response Body

application/json
  1. response
data*array<unknown>
meta*string
Example Request
curl -X GET 'https://aexrux.com/api/v1/broadcasts/0'
Example Response
{  "data": [    null  ],  "meta": "string"}
GET
/broadcasts/{id}/recipients

Authorization

http
headerAuthorizationBearer <token>

Path Parameters

id*integer

Response Body

application/json
  1. response
data*array<>
meta*
Example Request
curl -X GET 'https://aexrux.com/api/v1/broadcasts/0/recipients'
Example Response
{  "data": [    {      "contact_id": 0,      "status": "string",      "error": "string",      "wa_message_id": "string",      "sent_at": "string",      "delivered_at": "string",      "read_at": "string"    }  ],  "meta": {    "count": 0,    "stats": "string"  }}
POST
/broadcasts/{id}/stop

Authorization

http
headerAuthorizationBearer <token>

Path Parameters

id*integer

Response Body

application/json
  1. response
data*array<unknown>
meta*string
Example Request
curl -X POST 'https://aexrux.com/api/v1/broadcasts/0/stop'
Example Response
{  "data": [    null  ],  "meta": "string"}