Reschedule an email | Nexiom Connect

PATCH/v1/emails/messages/{messageId}

Authorization

Bearer token

Authorizationrequiredheader: Send your API key as Bearer YOUR_API_KEY.
Permissionemail.send: A key restricted to one sending domain can reschedule only emails sent from that domain.

Path parameters

messageIdrequiredstring: The messageId returned when you scheduled the send.

Body parameters

application/json

scheduledAtrequiredstring: The new send time, as an ISO 8601 timestamp with a timezone offset. Must be in the future and at most 30 days after the email was first scheduled.

Response

application/json200 OK

Every scheduled delivery of the message moves to the new time, and email.scheduled fires again with the new scheduled_at. Only the time changes; to change the content, cancel the email and send a new one.

curl -X PATCH "https://api-connect.nxiom.com/api/v1/emails/messages/YOUR_MESSAGE_ID" \
  -H "Authorization: Bearer $NEXIOM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "scheduledAt": "2026-10-06T09:00:00+01:00"
}'

Set NEXIOM_API_KEY in your environment.

{
  "message": "Scheduled email rescheduled",
  "data": {
    "messageId": "message_example",
    "status": "scheduled",
    "scheduledAt": "2026-10-06T08:00:00.000Z",
    "deliveryIds": [
      "delivery_example"
    ]
  }
}

Scheduled email rescheduled.

Authorization#

Path parameters#

Body parameters#

Response#

Authorization

Path parameters

Body parameters

Response