Scheduling Emails

Add a scheduledAt field in ISO 8601 format to schedule delivery.

• Up to 72 hours in advance
• API responds with 202 Accepted immediately
• Delivered automatically at the scheduled time

Parameters

Field	Type	Required	Description
scheduledAt	string	No	ISO 8601 datetime. Must be future, within 72 hours.

Example

POST https://api.cm.com/email/gateway/v1/transactional?priority=high
Content-Type: application/json
X-CM-PRODUCTTOKEN: {your-product-token}

{
  "from": { "email": "[email protected]", "name": "Sender Name" },
  "to": [{ "email": "[email protected]", "name": "Recipient Name" }],
  "scheduledAt": "2026-06-10T18:14:00+02:00",
  "subject": "Email Subject",
  "html": "<p>HTML content</p>",
  "text": "Plain text content"
}

Webhook Event

A Scheduled event is fired when the email is queued.

{
  "type": "scheduled",
  "createdAt": "2026-06-12T10:44:17+00:00",
  "data": {
    "to": "[email protected]",
    "scheduled": {
      "scheduledAt": "2026-06-12T10:45:00+00:00",
      "message": "Email is scheduled to be sent at June 12, 2026 at 10:45 UTC."
    }
  }
}