Webhook events

Every event type emitted by ephemail, with example payloads.

message.received

An address received a new inbound email.

{
  "type": "message.received",
  "id": "evt_01HZW...",
  "data": {
    "message_id": "msg_01HZ...",
    "address": "qa-x@ephemail.io",
    "from": "noreply@vendor.com",
    "subject": "Verify your email",
    "otp": "483920"
  }
}
address.created

A new address was created.

{
  "type": "address.created",
  "data": {
    "email": "qa-x@ephemail.io"
  }
}
address.expired

An address reached its TTL.

{
  "type": "address.expired",
  "data": {
    "email": "qa-x@ephemail.io"
  }
}
domain.verified

A custom domain became active.

{
  "type": "domain.verified",
  "data": {
    "domain": "mail.acme.com"
  }
}
send.delivered

Outbound message accepted by the recipient.

{
  "type": "send.delivered",
  "data": {
    "message_id": "out_..."
  }
}
send.bounced

Outbound message hard-bounced.

{
  "type": "send.bounced",
  "data": {
    "message_id": "out_...",
    "reason": "5.1.1"
  }
}