Send Calendar Event Message for Approval

Builds the event's message from its settings exactly as Create Message would and holds it, then emails the publication's approvers an approval test copy (texts their mobile numbers for SMS) with links to approve or deny. Pass approver_ids to send the test to only those approvers (from the event message's approvers); leave it out to send to all of them. Who received it is recorded on the round as recipients, and only they can decide. Nothing reaches subscribers until an approver approves; approving queues the message for the event's start time. The event must be ready (see get_calendar_event_message), and the publication needs at least one approver. An event has one live message: while one is held or approved, its settings and send time are locked, and it must be withdrawn (withdraw_calendar_event_message) before sending again. Returns the event message in the same shape as get_calendar_event_message, with the new round under approval.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The calendar event ID

Body Params
approver_ids
array of integers

Send the approval test to only these active approvers of the publication. Omit to send to all.

approver_ids
Responses
201

The message was built and the approval test sent

404

The event has no message

409

A held or approved message exists (withdraw it first), or the message was already sent

422

Not ready (data.missing lists what blocks the build), or approver_ids names someone who isn't an active approver, or no chosen approver has a mobile phone for SMS

Language
Credentials
Bearer
JWT
URL
LoadingLoading…