Broadcasts

Schedule or reschedule a broadcast

Schedules a draft for future delivery, or changes the delivery time of an existing scheduled Broadcast. This uses Mailrith's durable scheduled-send path and does not start delivery immediately.

put/v1/broadcasts/{broadcast_id}/schedule

Request

  • Base URL: https://api.mailrith.com
  • URL: https://api.mailrith.com/v1/broadcasts/{broadcast_id}/schedule
  • Auth: HTTP bearer

Path parameters

broadcast_idstring required

The broadcast identifier.

Request body

scheduled_atstring required

A future date and time. Include an explicit UTC offset or Z suffix.

Example request

{
  "scheduled_at": "2026-08-01T09:30:00.000Z"
}

Response

Broadcast scheduled

Example response

{
  "data": {
    "audience_definition": {
      "match": "all",
      "groups": [
        {
          "id": "active-subscribers",
          "match": "all",
          "conditions": [
            {
              "id": "active-status",
              "field": "subscriber_status",
              "operator": "is",
              "value": [
                "Active"
              ]
            }
          ]
        }
      ]
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.