Email Events

Email Delayed

Triggered when an email delivery is temporarily delayed.

This typically occurs due to temporary issues like:

  • Recipient server temporarily unavailable
  • Rate limiting by recipient server
  • Greylisting

Ark will automatically retry delivery. You'll receive a MessageSent or MessageDeliveryFailed event when the final outcome is determined.

postWebhookMessageDelayed

Payload

event'MessageSent' | 'MessageDelayed' | 'MessageDeliveryFailed' | 'MessageBounced' | 'MessageHeld' | 'MessageLoaded' | 'MessageLinkClicked' | 'DomainDNSError' required

The type of event that occurred

timestampinteger required

Unix timestamp when the event occurred

Example payload

{
  "event": "MessageSent",
  "timestamp": 1704672000,
  "payload": {
    "message": {
      "id": "12345",
      "token": "abc123",
      "to": "user@example.com",
      "from": "hello@yourdomain.com",
      "subject": "Welcome to our service",
      "tag": "onboarding",
      "message_id": "<abc123@mail.arkhq.io>",
      "metadata": {
        "user_id": "usr_123456",
        "order_id": "ord_789012"
      }
    },
    "status": "Sent",
    "details": "250 OK",
    "url": "https://yourdomain.com/welcome",
    "ip_address": "203.0.113.45",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
  }
}

Response

Webhook received successfully

Changes