Approve and send a draft newsletter
Atomically claims a draft, stamps the current actor, clears any scheduling and queues the saved current eligible audience. Any non-draft state returns400; concurrent claim returns409. Suppressed/empty audiences become skipped; large-audience eligibility is deferred. The receipt does not confirm final delivery. Requires permission: one of newsletter.
Authorizations
Passport bearer token authentication for legacy admin sessions.
Path Parameters
Id in the current organization.
Response
Operation result.
Send/approve/retry receipt; id/title/schedule fields depend on operation. Successful queueing does not prove provider acceptance or inbox delivery.
"News letter is being sent"
draft, scheduled, sending, sent, failed, skipped "sending"
Organization-owned record identifier.
42
"Education field update"
"2026-10-20T12:00:00Z"
"Africa/Kampala"
"Africa/Kampala"
"calendar"
Count.
x >= 01
Null while eligibility is deferred for audiences larger than500.
x >= 01
Null while eligibility is deferred for audiences larger than500.
x >= 00
Present and true only when eligibility is deferred.
true