email.received

Event triggered whenever Resend successfully receives an email.

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 (e.g., email.received).

• created_at (string) — ISO 8601 timestamp when the webhook event was created.

• data (object) — Event-specific data containing detailed information about the event. The data object for the email.received event contains the following parameters:

  object parameters

  • broadcast_id (string) — Unique identifier for the broadcast campaign (if applicable)
  • created_at (string) — ISO 8601 timestamp when the email was created
  • email_id (string) — Unique identifier for the specific email
  • message_id (string) — RFC Message-ID header value for the email
  • from (string) — Sender's email address. For sent events, this matches the value passed at send time and may include a display name (e.g., Name <email@domain.com>). For received events, this is the bare email address only; the display name from the original From: header is preserved in headers.from on the retrieve endpoint.
  • to (array) — Array of impacted recipient email addresses
  • subject (string) — Email subject line
  • template_id (string) — Unique identifier for the template used (if applicable)
  • tags (Record<string, string>) — Object of tag key-value pairs associated with the email.

    Example:

    {
      "category": "welcome",
      "user_id": "1234567890"
    }

  • received_for (array) — The recipient addresses the email was forwarded for, taken from the for clause of the message's Received headers.

{
  "type": "email.received",
  "created_at": "2026-02-22T23:41:12.126Z",
  "data": {
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "created_at": "2026-02-22T23:41:11.894Z",
    "from": "onboarding@resend.dev",
    "to": ["delivered@resend.dev"],
    "bcc": [],
    "cc": [],
    "received_for": ["forwarded@example.com"],
    "message_id": "<111-222-333@email.example.com>",
    "subject": "Sending this example",
    "attachments": [
      {
        "id": "2a0c9ce0-3112-4728-976e-47ddcd16a318",
        "filename": "avatar.png",
        "content_type": "image/png",
        "content_disposition": "inline",
        "content_id": "img001"
      }
    ]
  }
}