Schedule email to list | Subrite

Schedule email to list

Schedule an email to a list for a later time. Set scheduledAt as an ISO 8601 datetime and optionally a timeZone; without a timeZone the time is treated as UTC.

ReferenceUpdated September 23, 2026View as Markdown

Schedule an email to a list through Subrite.

Method: POST
Route: {baseUrl}/api/v1/communications/email/schedule
Authorization: Bearer token (use the M2M token from )
Body: see the example below

Example body#

javascript

{
  "communicationType": "marketing",  // Possible values: "marketing" or "information"
  "name": "sample name",
  "senderId": 2,  // Use sender ID from Step 2 response
  "consentId": null,
  "segmentId": 1,  // Use segment ID from Step 3 response
  "subject": "email subject",
  "emailPreviewText": "sample",
  "emailContent": "<div>hello world</div>",
  "scheduledAt": "2025-03-26T05:14:25.064Z", // Set norway time
  "timeZone": "Europe/Oslo", // Optional: If not provided, UTC will be used
  "hostName": "example.com" // Optional. See "Host name" below.
}