Endpoints
Campaigns
Broadcast campaigns created in the app: status, results and sending.
Pfade sind relativ zur Basis-URL. Jede Karte zeigt die Berechtigung, die der Aufruf braucht, und jeden Parameter mit Typ und Grenzen.
GET
/campaignsList campaigns, newest first.
Berechtigung: campaigns
Paginiert
Query-Parameter
- statusoptionalenum
Campaign status.
Erlaubte Werte:
draftscheduledsendingcompletedfailed
GET
/campaigns/:idRetrieve a campaign with its delivery stats.
Berechtigung: campaigns
Pfadparameter
- iderforderlichstring
Campaign ID.
POST
/campaigns/:id/sendSend a draft, scheduled or failed campaign now, or schedule it.
Berechtigung: campaigns
Pfadparameter
- iderforderlichstring
Campaign ID.
JSON-Body
- send_atoptionalstring (ISO 8601 date-time with offset) | null
Schedule for this time. Omit or null to send now.
- Sending now answers 202 and runs in the background; campaign.completed fires when it finishes. Scheduling answers 200.
- 402 insufficient_credits when the workspace cannot pay for the send; 409 for a campaign that is already sending or completed.