Skip to main content
The Vercel integration connects Kestrel to your Vercel projects, enabling deployment events to trigger workflows and giving AI agents access to build logs, deployment status, and rollback capabilities.

​
Prerequisites

  • Organization Admin role in Kestrel
  • Vercel account with project access

​
Setup

1

Connect via OAuth

  1. Navigate to Integrations → Vercel in your Kestrel dashboard
  2. Click Connect
  3. Authorize Kestrel in the Vercel OAuth popup
  4. Select the Vercel team/account and projects to authorize
  5. The popup closes and your Vercel account appears as connected
2

Configure the webhook

After OAuth connection, Kestrel automatically registers a webhook with your Vercel account to receive deployment and error events. No manual webhook configuration is required.

​
How It’s Used

​
In Workflows

Trigger blocks:
  • Deployment Failed — fires when a Vercel deployment build fails
  • Deployment Succeeded — fires when a deployment completes successfully
  • Deployment Created — fires when a new Vercel deployment is initiated
  • Error Anomaly — fires when Vercel detects an anomalous spike in runtime errors
  • Usage Anomaly — fires when Vercel detects unusual usage patterns
  • Domain Issue — fires on domain configuration or certificate problems
  • Firewall Attack Detected — fires when Vercel’s firewall detects a potential attack
  • Deployment Checks Failed — fires when deployment integration checks fail
  • Production Rollback — fires when a production deployment is rolled back
Action blocks:
  • Get Deployment — retrieve deployment details including status, URL, and git commit
  • Get Build Logs — fetch build log output for a specific deployment
  • Rollback Production — roll back production to a previous stable deployment
  • Promote to Production — promote a preview deployment to production
  • List Deployments — list recent deployments with optional filters
  • Investigate Vercel — run an AI investigation combining build logs, error data, and deployment history
Example: A workflow triggers on a failed deployment, fetches the build logs, analyzes the failure with AI, and posts a summary to Slack with a one-click rollback button.

​
Disconnecting

  1. Navigate to Integrations → Vercel
  2. Click Disconnect
  3. Confirm the disconnection
This removes the webhook and stops all Vercel workflow triggers. You can reconnect at any time.