Reschedule an email
PATCH/v1/emails/{id}
Changes when a scheduled email goes out, from now up to 30 days ahead. Only possible while the email is still waiting: once it is on its way it returns 409 not_schedulable.
Required scope: emails:send
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The email id. |
Request body
| Field | Type |
|---|---|
scheduled_atrequired | string |
Unknown fields are rejected, so a typo never silently does nothing.
Example
curl -X PATCH 'https://api.sendsend.email/v1/emails/ID' \
-H "Authorization: Bearer $SENDSEND_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"scheduled_at": "2026-10-08T09:00:00-04:00"
}'Response 200
{
"id": "msg_8Xk2…",
"status": "scheduled",
"scheduled_at": "2026-10-08T13:00:00.000Z"
}Errors
| Status | Code | When |
|---|---|---|
| 400 | validation_error | The request body or parameters are invalid. The message says which field. |
| 404 | not_found | No such resource in this project. |
| 409 | not_schedulable | The email is not scheduled any more (sent, cancelled or on its way). |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.