Webhooks

Em Webhooks, cadastre um endereço https:// do seu app e escolha os eventos: email.sent, email.delivered, email.delivery_delayed, email.bounced, email.complained, email.failed, email.suppressed, email.scheduled, email.received, email.opened e email.clicked. A API /webhooks é a mesma do Resend.

Formato e assinatura

Cada evento chega como POST JSON no formato do Resend ({ "type": "email.delivered", "created_at": "…", "data": { "email_id": "…", "to": […], … } }), assinado no padrão Standard Webhooks com o segredo whsec_… do webhook (cabeçalhos webhook-id, webhook-timestamp, webhook-signature e os mesmos como svix-*). Verifique com o SDK:

const event = resend.webhooks.verify({ payload: corpoCru, headers: { id, timestamp, signature }, webhookSecret: "whsec_…" });

Tentativas

Responda com 2xx. Fora do ar ou com erro, tentamos de novo com intervalos crescentes por cerca de um dia; a página do webhook mostra as últimas tentativas.