Webhook Event Types

Mailofly emits structured event notifications for the following events:

Event Catalog

Event Name	Triggered When
`email.sent`	Message handed off to the destination MTA.
`email.delivered`	Message successfully accepted by recipient’s server.
`email.opened`	Recipient loaded the open tracking pixel.
`email.clicked`	Recipient clicked an email link.
`email.bounced`	Hard or soft bounce reported by destination server.
`email.complained`	Recipient marked email as spam / junk.
`contact.created`	New contact added to your audience.
`domain.verified`	Domain DNS records passed verification.

Sample Payload: `email.delivered`

{
  "event": "email.delivered",
  "created_at": "2026-09-11T00:45:00Z",
  "data": {
    "email_id": "msg_01J8G52XYZ9A8B7C6D",
    "from": "Acme <notifications@acme.com>",
    "to": ["user@example.com"],
    "subject": "Your Order Confirmation",
    "tags": {
      "order_id": "ord_1001"
    }
  }
}

Sample Payload: `email.bounced`

{
  "event": "email.bounced",
  "created_at": "2026-09-11T00:45:05Z",
  "data": {
    "email_id": "msg_01J8G52XYZ9A8B7C6D",
    "from": "Acme <notifications@acme.com>",
    "to": ["invalid-user@example.com"],
    "bounce_type": "permanent",
    "diagnostic_code": "550 5.1.1 User unknown"
  }
}

Related topics

Retrieve Webhook Create Webhook Delete Webhook Introduction Retries and debugging

⌘I