Schedule email by ID | Subrite

Schedule email by ID

Schedule an email by its ID. Only scheduledAt is required, and timeZone is optional (UTC is used when it is left out). The response includes the communication data.

ReferenceUpdated September 23, 2026View as Markdown

Schedule an email by its ID through Subrite.

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

Example body#

Only scheduledAt is required.

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
}