resend-webhooks

Resend Webhooks

When to Use This Skill

• Setting up Resend webhook handlers
• Debugging signature verification failures
• Understanding Resend event types and payloads
• Handling email delivery events (sent, delivered, bounced, etc.)
• Processing inbound emails via email.received events

Essential Code (USE THIS)

Express Webhook Handler (Using Resend SDK)

const express = require('express');
const { Resend } = require('resend');

const resend = new Resend(process.env.RESEND_API_KEY);
const app = express();

// CRITICAL: Use express.raw() for webhook endpoint - Resend needs raw body
app.post('/webhooks/resend',
  express.raw({ type: 'application/json' }),
  async (req, res) => {
    try {
      // Verify signature using Resend SDK (uses Svix under the hood)
      const event = resend.webhooks.verify({
        payload: req.body.toString(),
        headers: {
          id: req.headers['svix-id'],           // Note: short key names
          timestamp: req.headers['svix-timestamp'],
          signature: req.headers['svix-signature'],
        },
        webhookSecret: process.env.RESEND_WEBHOOK_SECRET  // whsec_xxxxx
      });

      // Handle the event
      switch (event.type) {
        case 'email.sent':
          console.log('Email sent:', event.data.email_id);
          break;
        case 'email.delivered':
          console.log('Email delivered:', event.data.email_id);
          break;
        case 'email.bounced':
          console.log('Email bounced:', event.data.email_id);
          break;
        case 'email.received':
          console.log('Email received:', event.data.email_id);
          // For inbound emails, fetch full content via API
          break;
        default:
          console.log('Unhandled event:', event.type);
      }

      res.json({ received: true });
    } catch (err) {
      console.error('Webhook verification failed:', err.message);
      return res.status(400).send(`Webhook Error: ${err.message}`);
    }
  }
);