Event Types

Reloop supports the following active event types. Each delivery uses a consistent top-level envelope; event-specific fields live under data.

Email lifecycle

Event	Description
`email.sent`	Email accepted for delivery
`email.delivered`	Delivered to the recipient MTA
`email.bounced`	Permanent delivery failure
`email.delivery_delayed`	Transient failure / delay
`email.complained`	Recipient marked as spam (feedback loop)
`email.failed`	Permanent send failure before delivery
`email.opened`	Recipient opened the email
`email.clicked`	Recipient clicked a link in the email
`email.received`	Inbound email successfully received
`email.scheduled`	Email scheduled for later delivery
`email.suppressed`	Email suppressed (recipient on suppression list)

Email `data` shape

{
  "email_id": "em_…",
  "from": "Acme <onboarding@example.com>",
  "to": ["user@example.com"],
  "subject": "Hello",
  "status": "delivered",
  "error": {
    "code": 550,
    "message": "User unknown"
  }
}

error is present on bounce, delay, complaint, and failure events.

Domain lifecycle

Event	Description
`domain.create`	Domain created
`domain.update`	Domain updated
`domain.delete`	Domain deleted
`domain.undelete`	Domain restored
`domain.verify`	Domain DNS verified

API key lifecycle

Event	Description
`api-key.create`	API key created
`api-key.update`	API key updated / enabled / disabled / rotated
`api-key.delete`	API key deleted
`api-key.revoke`	API key revoked
`api-key.rate_limited`	API key exceeded its rate limit

Contact lifecycle

Event	Description
`contact.create`	Contact created
`contact.update`	Contact updated
`contact.delete`	Contact deleted
`contact.subscribed`	Contact subscribed
`contact.unsubscribed`	Contact unsubscribed
`contact.blocked`	Contact blocked
`contact.group.create`	Contact group created
`contact.group.update`	Contact group updated
`contact.group.delete`	Contact group deleted

Envelope

{
  "id": "whev_…",
  "type": "email.delivered",
  "created_at": "2026-07-22T12:00:00.000Z",
  "data": { }
}