> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usekestrel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vercel

> Connect Vercel for deployment event triggers, build log access, and rollback actions in workflows

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

<Steps>
  <Step title="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
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.