Webhook event · Delivery

retrying

Sent each time an email could not be delivered yet and will be tried again.

i

Delivered as a signed POST to your webhook URL. See Setup & Events for how to verify the signature.

Payload

// Connection retry
{
  "event": "retrying",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T04:32:10.000Z",
  "data": {
    "recipientEmail": "user@example.com",
    "fromAddress": "hello@yourdomain.com",
    "reason": "Connection retry 2/10"
  }
}
!

Not a final status. The same email can send retrying several times. It always ends with a final event: delivered, bounced, spam or failed.

i

Control how many times we retry. Set the limits per email, or see how each kind of retry works.

Delivery options →

Field reference

  • event

    Fixed value: "retrying".

  • emailId

    ID of the email, the same one returned by POST /send.

  • timestamp

    When the event happened (ISO 8601, UTC).

  • data.recipientEmail

    Recipient email address.

  • data.fromAddress

    Sender email address.

  • data.reason

    What happened. For connection retries and greylisting it includes the attempt, like "2/10"; for rate limits it is the answer from the provider.