Vercel Integration

Set up HookWatch to receive Vercel webhooks for deployment events like builds, deployment status changes, and project configuration updates.

Prerequisites

A HookWatch account
A Vercel account with a project deployed
A server endpoint to process webhook payloads

Step 1: Create a HookWatch endpoint

Go to your Endpoints page
Click "Create Endpoint"
Enter a name like "Vercel Webhooks"
Enter your destination URL (where you want webhooks forwarded)
Copy the generated webhook URL

Your HookWatch URL will look like:

https://hook.hookwatch.dev/wh/abc123xyz

Step 2: Configure Vercel webhooks

Go to your Vercel Dashboard
Navigate to Account Settings > Webhooks (or Project Settings > Webhooks for project-level webhooks)
Click "Create Webhook"
Paste your HookWatch URL in the "Endpoint URL" field
Select the events you want to subscribe to
Optionally filter by project
Click "Create"
Copy the generated webhook secret for signature verification

Available webhook events:

deployment.created

deployment.succeeded

deployment.ready

deployment.error

deployment.canceled

project.created

project.removed

domain.created

Step 3: Verify webhooks on your server

Vercel signs webhook payloads using HMAC-SHA1. HookWatch forwards the x-vercel-signature header so you can verify authenticity.

Node.js / Express

Vercel webhook headers

HookWatch forwards all Vercel headers. Here are the important ones:

Header	Description
`x-vercel-signature`	HMAC-SHA1 hex digest for verification
`user-agent`	Contains Vercel webhook client identifier

Testing the integration

Push a commit to a repository connected to your Vercel project
Trigger a manual deployment from the Vercel dashboard
Check your HookWatch Events page to see deployment events

Each deployment triggers multiple events as it progresses through stages (created, building, ready/error).

Common issues

Signature verification fails

Make sure you're using the webhook secret generated when you created the webhook, not your Vercel API token. Each webhook has its own unique secret.

Not receiving project-level events

Account-level webhooks receive events for all projects. If you set up a project-level webhook, it only receives events for that specific project.

Webhook disabled automatically

Vercel disables webhooks after repeated failures. With HookWatch's reliable endpoint, this is unlikely, but check the webhook status in your Vercel dashboard if events stop arriving.