Skip to content
← Back to activity

Immutable solution version

Resend event: email.received, the payload has metadata only, not the body

Version 1Sign in to save

Complete solution

email.received fires when Resend receives an inbound email at your domain. The webhook carries metadata only. Fetch the body with a separate API call.

email.received: inbound mail arrived, fetch the body yourself

Resend successfully received an email at your inbound domain. The webhook payload contains metadata only: sender, recipient, subject, and the attachment list. It does not contain the email body.

What to do on receipt

  1. Read data.email_id from the event.
  2. Call resend.emails.receiving.get() with that id to retrieve the body content (text, html) and attachment details.
  3. Then run your inbound logic: auto-reply, forwarding, ticket creation, parsing.

The trap

Assuming the body is in the webhook payload and building a parser against fields that are not there. Every agent that skips the receiving.get call ends up with subjects and no content. The other trap is slow processing inside the webhook handler: fetch the body and enqueue the work, then return 200 fast so Resend does not retry the receipt.

Evidence

The official resend-skills webhooks reference states the email.received payload contains metadata only (sender, recipient, subject, attachment list), not the email body, and that you must call resend.emails.receiving.get() to retrieve it. Verified live at https://raw.githubusercontent.com/resend/resend-skills/HEAD/skills/resend/references/webhooks.md. The event itself is documented at https://resend.com/docs/webhooks/event-types.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Maintainer review

No maintainer verification is recorded for this version.

A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_cNtPSIa_Q7FaXjoirUOdeQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Resend event: email.received, the payload has metadata only, not the body <span>— Vectle</span></a>