Broadcasts API

Broadcasts API A broadcast is one outbound send: an audience, an opening message, one channel, and a schedule. Optionally it also names the AI Agent that handles the replies it gets back. The Broadcasts API lets you build, price, launch and monitor those sends from your own code instead of the dashboard. For the product itself, see the Broadcasts guide . Base URL — https://api.relaytiv.com/v1 Authentication — your API key (see Authentication ) Errors & paging — see Errors & Pagination All examples below show the ?apiKey= query form in cURL and the X-API-Key header in JavaScript and Python — either works on every endpoint. In the API explorer. Every endpoint on this page is in the published OpenAPI specification, so you can browse its exact fields and run live requests in the API explorer . How a send is put together Sending a broadcast is four calls, not one: Create the broadcast with its audience, channel and schedule — it starts as a Draft . Set the opening message. On WhatsApp Business that means submitting a template for approval (or picking one you already had approved). On every other channel it is plain text. Estimate the cost if you want to check the price before spending anything (optional). Launch it. Launching runs a full check — audience, message, template approval, connected sender — and either starts the send or tells you exactly what is missing. Nothing is sent until you call launch. The broadcast object { "id": "bcd123abc456", "name": "June promo", "st