Skip to main content
Add a schedule to any send request to choose when AhaSend makes the first delivery attempt, when the message expires, or both. Available on Free, Pro and Max. See plans and features.

How do I schedule an email?

Set schedule.first_attempt to the moment the email should go out, in RFC3339 format:
The response returns each message with status: "scheduled" and its schedule. Keep the message id if you may want to cancel it. Times with a Z are in UTC; you can also give an offset, such as 2026-11-20T09:00:00+01:00.

How do I stop an email from arriving too late?

Set schedule.expires. If the message hasn’t been delivered by then, for example because the receiving server kept deferring it, AhaSend drops it instead of delivering it late. This is useful for anything that loses its value with time, such as a login code or a one-time password: set expires to the moment the code stops working, and the recipient never receives a code that no longer works. You can set expires without first_attempt; the message then goes out right away.

How do I cancel a scheduled email?

Call Cancel Message with the message’s id before its first attempt:
The API key needs messages:cancel:all, or the cancel scope for the sender’s domain. See permission scopes.