AI agents with Vercel webhooks
Receive Vercel webhooks on Trigger.dev and use them to start, resume or message your AI agents.
What you can do with Vercel webhooks
Start an agent
Vercel events can start a new agent run. For example, an agent that investigates every failed Vercel deployment.
Resume an agent
An agent can pause until the Vercel event it needs arrives, for up to 90 days, and costs nothing while it waits.
Message an agent
Vercel events can land in a running agent's conversation, so it acts on them with full context.
Events you can receive from Vercel
Vercel sends events like deployment.created, deployment.succeeded, deployment.error and deployment.canceled, and your agent can filter on any of them.
Example
An agent that investigates every failed Vercel deployment
Handled for you
Verified for you
webhooks.vercel() checks the X-Vercel-Signature header on every request. Bad requests are rejected before anything runs.
Retries don't run twice
Retries are matched on event.id, so a retried webhook doesn't start a second run.
Filter before anything runs
Only the Vercel events you care about start a run. Filtered webhooks use no compute.
See every delivery
Every webhook is recorded with its payload, headers and the agents it reached, so you can debug it and replay it.
Get started
- 1
Set up the agent
Copy the starter prompt into your coding agent, like Claude Code, Cursor or Codex. It creates a Trigger.dev project and adds the webhook endpoint. Prefer to write it yourself? Start from the example above.
- 2
Add the webhook in Vercel
Deploy your project, or run
trigger dev, and the endpoint appears on the Webhooks page of the Trigger.dev dashboard with its URL. Add that URL in Vercel's webhook settings and pick the events you need. The endpoint's Copy setup prompt button gives your coding agent the exact steps. - 3
Add a signing secret
On the endpoint's page in the Trigger.dev dashboard, choose Generate secret. Then paste it into Vercel's webhook settings, so Trigger.dev can check every request really came from Vercel.
- 4
Try it
Send a test event from Vercel, or use the endpoint's Test tab. It appears on the endpoint's Deliveries tab, with the agents it reached.
Related integrations
Ready to build with Vercel webhooks?
Declare an endpoint, deploy, and paste the URL into your provider.