Preview a broadcast audience
Estimates how many fans an audience selector matches before scheduling, returning matched/selected counts and a non-PII distribution. Does not create or send anything. Requires a read-scoped key.
Authorization
bearerAuth Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/admin/broadcasts/preview" \ -H "Content-Type: application/json" \ -d '{ "audience": { "tier": "whales", "status": "active" } }'{ "matched": 1240, "selected": 1000, "histogram": { "whale": 120, "regular": 640, "new": 240 }}{ "detail": "Not authenticated"}Create a broadcast campaign
Creates a draft broadcast campaign in one of four modes (segmented, tiered, drip-with-auto-stop, online_trigger). Sends are screened, paced, and behind an off-by-default delivery gate; creating a campaign does not deliver anything. Requires a write-scoped key.
Get a broadcast campaign with stats
Returns one campaign with its delivery/ROI rollup and, for drip campaigns, the per-step funnel. Requires a read-scoped key.