For the complete documentation index, see llms-docs.txt or the site index llms.txt. Full docs corpus: llms-full-docs.txt. Prefer the markdown version of this page at /docs/webhooks/emails/scheduled.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: /mcp.

email.scheduled

Webhook event triggered when an email is scheduled for later delivery.

{
  "id": "whev_01h…",
  "type": "email.scheduled",
  "created_at": "2026-07-22T12:00:00.000Z",
  "data": {
    "email_id": "em_123456789",
    "from": "sender@example.com",
    "to": ["recipient@example.com"],
    "subject": "Hello World",
    "status": "scheduled",
    "scheduled_at": "2026-07-23T09:00:00.000Z"
  }
}

The email.scheduled event is triggered when an email is accepted with a future scheduled_at time. It replaces email.sent for that message; later lifecycle events (email.delivered, email.bounced, …) still fire when the message is actually processed.

Event Details

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

type string

The event type that triggered the webhook (email.scheduled).

created_at string

ISO 8601 timestamp when the webhook event was created.

data object

Standard outbound email fields with status: "scheduled" and scheduled_at (ISO 8601).

Handling this event

When your endpoint receives an email.scheduled event, you might want to:

  • Show the message as queued for a future send in your UI.
  • Cancel or reschedule downstream automations until delivery.

Learn More

Was this page helpful?

Edit this page