---
title: How can I run end-to-end tests after my Vercel Preview Deployment?
description: Learn how to use the Vercel CLI in combination with your CI/CD provider to run end-to-end tests for every code change.
url: "https://vercel.com/kb/guide/how-can-i-run-end-to-end-tests-after-my-vercel-preview-deployment"
published: 2025-11-03
last_updated: 2026-09-28
authors: Anthony Shew
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

You can run an end-to-end test suite after your Vercel deployment has finished with the following methods:

- [Using GitHub Actions' repository\_dispatch events](#using-github-actions'-repository_dispatch-events)
  
- [Using webhooks with other CI providers](#using-webhooks-for-other-ci-providers)
  

If your project has [Deployment Protection](https://vercel.com/docs/deployment-protection) enabled, ensure you use [Protection Bypass for Automation](https://vercel.com/docs/deployment-protection/methods-to-bypass-deployment-protection/protection-bypass-automation) so your test environments can reach your deployments.

## Using GitHub Actions' `repository_dispatch` events

1. Connect your Git repository to your project. For new projects, you can [follow these docs](https://vercel.com/docs/concepts/git#deploying-a-git-repository). For existing projects, visit your Git configuration in the Settings tab of your project dashboard.
   
2. Create a GitHub workflow in `.github/workflows` with the following:
   

```text
name: Playwright Tests

on:
  repository_dispatch:
    types:
      - 'vercel.deployment.success'
jobs:
  run-e2es:
    if: github.event_name == 'repository_dispatch'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.client_payload.git.sha }}
      - name: Install dependencies
        run: npm ci && npx playwright install --with-deps
      - name: Run tests
        run: npx playwright test
        env:
          BASE_URL: ${{ github.event.client_payload.url }}
```

## Using webhooks for other CI providers

1. [Configure a webhook](https://vercel.com/docs/webhooks#configure-a-webhook) for the `deployment.succeeded` event.
   
2. Listen for the webhook to trigger your CI workflow.
   
3. Run end-to-end test suites.

## More Vercel CLI guides

- [How to alias a preview deployment using the CLI](/kb/guide/how-to-alias-a-preview-deployment-using-the-cli): Learn how to automatically alias a Vercel preview deployment.
- [Build a fullstack app with Next.js 16 and Prisma Postgres](/kb/guide/nextjs-prisma-postgres): Create a fullstack blog with the Next.js App Router, Prisma, Sign in with Vercel, Prisma Postgres from the Vercel Marketplace, and deploy it to Vercel.
- [The Complete Guide to Vercel Connect](/kb/guide/vercel-connect): Use Vercel Connect to call provider APIs like Slack, GitHub, Linear, Microsoft, Discord, Snowflake, and Salesforce from your agents and services with short-lived, scoped tokens instead of long-lived secrets.