Cancel a scheduled email | Nexiom Connect

POST/v1/emails/messages/{messageId}/cancel

Authorization

Bearer token

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

Path parameters

messageIdrequiredstring: The messageId returned when you scheduled the send.

Response

application/json200 OK

Every scheduled delivery of the message becomes canceled, and email.canceled fires for each one.

Cancelling an email that is already canceled returns the same result, so retrying is safe. Recipients that were suppressed when you scheduled the send keep the suppressed status.

curl -X POST "https://api-connect.nxiom.com/api/v1/emails/messages/YOUR_MESSAGE_ID/cancel" \
  -H "Authorization: Bearer $NEXIOM_API_KEY"

Set NEXIOM_API_KEY in your environment.

{
  "message": "Scheduled email canceled",
  "data": {
    "messageId": "message_example",
    "status": "canceled",
    "canceledAt": "2026-10-04T12:00:00.000Z",
    "deliveryIds": [
      "delivery_example"
    ]
  }
}

Scheduled email canceled.

Authorization#

Path parameters#

Response#

Authorization

Path parameters

Response