vercel-webhooks

name	vercel-webhooks
description	Receive and verify Vercel webhooks. Use when setting up Vercel webhook handlers, debugging signature verification, or handling deployment events like deployment.created, deployment.succeeded, or project.created.
license	MIT
metadata	{"author":"hookdeck","version":"0.1.0","repository":"https://github.com/hookdeck/webhook-skills"}

Vercel Webhooks

When to Use This Skill

• Setting up Vercel webhook handlers
• Debugging signature verification failures
• Understanding Vercel event types and payloads
• Handling deployment, project, domain, or integration events
• Monitoring deployment status changes

Essential Code (USE THIS)

Express Webhook Handler with Manual Verification

const express = require('express');
const crypto = require('crypto');

const app = express();

// CRITICAL: Use express.raw() for webhook endpoint - Vercel needs raw body
app.post('/webhooks/vercel',
  express.raw({ :  }),
   (req, res) => {
     signature = req.[];

     (!signature) {
       res.().();
    }

    
     expectedSignature = crypto
      .(, process..)
      .(req.)
      .();

    
     signaturesMatch;
     {
      signaturesMatch = crypto.(
        .(signature),
        .(expectedSignature)
      );
    }  (err) {
      
      signaturesMatch = ;
    }

     (!signaturesMatch) {
      .();
       res.().();
    }

    
     event = .(req..());

    
     (event.) {
       :
        .(, event...);
        ;
       :
        .(, event...);
        ;
       :
        .(, event...);
        ;
       :
        .(, event...);
        ;
      :
        .(, event.);
    }

    res.({ :  });
  }
);