Scheduled Sending

What it does

Scheduled sending lets you hand mailkube an email now and have it delivered later. Add a scheduled_at timestamp to any normal send, and instead of going out immediately, the message waits until the time you set and is transmitted then.

Everything that decides the message is settled the moment you schedule: your quota is charged, the template is rendered, and the send is authorized once, up front. When the due time arrives, mailkube transmits the message you already composed. You can schedule anything from a few minutes to 30 days ahead. Read the full details in the scheduled sending guide.

Key benefits

• Schedule with a single field. Add scheduled_at (an ISO-8601 timestamp with a timezone offset) to a send and you are done. Any valid offset is accepted and normalized for you. Times are explicit timestamps, so there is no guesswork over what “next Monday” means.
• Group a campaign with batch_id. Tag related scheduled sends with a shared batch_id, then reschedule or cancel the whole batch in one call. Useful when a launch slips and every message needs to move together.
• Change your mind before it sends. Retrieve, list and filter, reschedule, or cancel any pending send, one email or a full batch. Content stays fixed once scheduled, but the time is yours to move right up until the message goes out.
• Full visibility on your webhooks. An email.scheduled event fires when you queue a send, email.sent fires the moment it is actually transmitted, and email.failed tells you if a due-time check dropped it. See the webhooks guide for the payloads.

Getting started

1. Add scheduled_at to a normal send, using an ISO-8601 timestamp with a timezone offset (for example 2026-08-20T09:00:00+02:00)
2. Optionally add a batch_id to group the send with others in the same campaign
3. Send over the REST API as usual. The response confirms the message is scheduled rather than sent
4. List, reschedule, or cancel your scheduled sends any time before the due time, and watch your webhooks for email.scheduled, email.sent, and email.failed

Scheduled sending is a plan feature. See Pricing for availability, and the scheduled sending guide for the full API.