For the complete documentation index, see llms-docs.txt or the site index llms.txt. Full docs corpus: llms-full-docs.txt. Prefer the markdown version of this page at /docs/webhooks/emails/received.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: /mcp.

email.received

Webhook event triggered when an inbound email is received.

{
  "id": "whev_01h…",
  "type": "email.received",
  "created_at": "2026-07-22T12:00:00.000Z",
  "data": {
    "email_id": "in_123456789",
    "mailbox_id": "mb_123456789",
    "from": "sender@example.com",
    "from_name": "Sender",
    "to": ["inbound@yourdomain.com"],
    "cc": [],
    "subject": "Inbound Message",
    "thread_id": "thr_123456789",
    "has_attachments": false,
    "is_spam": false,
    "status": "received",
    "message_id": "<msg@example.com>"
  }
}

The email.received event is triggered when an inbound email is successfully received by Reloop.

Event Details

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

type string

The event type that triggered the webhook (email.received).

created_at string

ISO 8601 timestamp when the webhook event was created.

data object

Inbound fields: email_id, mailbox_id, from, from_name, to, cc, subject, thread_id, has_attachments, is_spam, status, message_id.

Handling this event

When your endpoint receives an email.received event, you might want to:

  • Process inbound messages for your application.
  • Fetch the full body via the inbox API using email_id.
  • Store attachments in your cloud storage.

Learn More

Was this page helpful?

Edit this page