Guides

Event Types

List of supported event types and their payload.

Suggest Edits

🚧

Service update

We’ve optimized the structure of webhook event payloads by removing redundant data and enhancing clarity. The new streamlined format delivers only the most relevant information, making it simpler to process and respond to webhook events efficiently.

Effective Date: October 21, 00:00 CET

delivered

Occurs when the email is successfully delivered to the recipients's mail server.

{
  "Type": "Delivered",
  "CreatedAt": "2025-10-13T05:55:50+00:00",
  "MessageId": "cea77391-d390-49e9-9251-75966ace0d4e",
  "Data": {
    "To": "[email protected]",
    "From": "[email protected]",
    "Id": "44685a9ba7f911f0ade692e7192d1ad5",
    "CustomerReference": "123-test",
 		"Unsubscribe": null,
    "Bounce": null
  }
}

opened

Occurs when the recipient opened the email.

{
  "Type": "Opened",
  "CreatedAt": "2025-10-16T23:05:34.9199655+00:00",
  "MessageId": "9b83ef3b-1a98-4656-a861-7278db4ac0cf",
  "Data": {
    "To": "[email protected]",
    "From": "[email protected]",
    "Id": "9b83ef3b-1a98-4656-a861-7278db4ac0cf",
    "CustomerReference": "test-email-001",
    "Unsubscribe": null,
    "Bounce": null
  }
}

ℹ️

Open tracking needs to be enabled within tracking settings to receive opened events.

clicked

Occurs when the recipient clicks on an email link.

{
  "Type": "Clicked",
  "CreatedAt": "2025-10-16T23:05:34.9199655+00:00",
  "MessageId": "9b83ef3b-1a98-4656-a861-7278db4ac0cf",
  "Data": {
    "To": "[email protected]",
    "From": "[email protected]",
    "Id": "9b83ef3b-1a98-4656-a861-7278db4ac0cf",
    "CustomerReference": "test-email-001",
    "Unsubscribe": null,
    "Bounce": null
  }
}

ℹ️

Click tracking needs to be enabled within tracking setting to receive clicked events.

Open tracking needs to be enabled within tracking settings.

bounced

Occurs when the recipient's mail server permanently rejected the email.

{
  "Type": "Bounced",
  "CreatedAt": "2025-10-16T11:14:03+00:00",
  "MessageId": "2aeee2f3-52cc-4f60-87c0-79e6d075c41d",
  "Data": {
    "To": "[email protected]",
    "From": "[email protected]",
    "Id": "3943011caa8111f0a953067ceeb66b99",
    "CustomerReference": "test-1234",
    "Unsubscribe": null,
    "Bounce": {
      "Type": "HardBounce",
      "SubType": "InvalidRecipient",
      "Message": "Delivery failed: The recipient's email address is invalid or does not exist. Please verify the address and try again."
    }
  }
}

unsubscribed

Occurs when the recipient unsubscribed by link or header from the email.

{
  "Type": "Unsubscribed",
  "CreatedAt": "2025-10-16T22:49:50.9076215+00:00",
  "MessageId": "2aeee2f3-52cc-4f60-87c0-79e6d075c41d",
  "Data": {
    "To": "[email protected]",
    "From": "[email protected]",
    "Id": "2aeee2f3-52cc-4f60-87c0-79e6d075c41d",
    "CustomerReference": "string",
    "Unsubscribe": {
      "UnsubscribeType": "UnsubscribedByLink",
      "UnsubscribeReason": "test webhook"
    },
    "Bounce": null
  }
}

complained

Occurs when the email is marked as spam by the recipient.

{
  "Type": "Complained",
  "CreatedAt": "2025-10-16T23:05:34.9199655+00:00",
  "MessageId": "9b83ef3b-1a98-4656-a861-7278db4ac0cf",
  "Data": {
    "To": "[email protected]",
    "From": "[email protected]",
    "Id": "9b83ef3b-1a98-4656-a861-7278db4ac0cf",
    "CustomerReference": "test-email-001",
    "Unsubscribe": null,
    "Bounce": null
  }
}

Updated about 24 hours ago