Engagement Events

Link Clicked

Triggered when a recipient clicks a link in an email.

Requirements:

  • Click tracking must be enabled for your domain
  • Links must be in the HTML body (plain text links are not tracked)

The url field contains the original destination URL that was clicked.

postWebhookMessageLinkClicked

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