Documentation
Integrations

Deployment Webhooks

Auto-trigger tests when you deploy via Vercel, Netlify, or GitLab. Tests run against preview deployments.

Deployment Webhooks

Auto-trigger AegisRunner tests when you deploy via Vercel, Netlify, or GitLab.

How It Works

  1. You deploy your site
  2. Your platform sends a webhook to AegisRunner
  3. AegisRunner runs tests against the deployment URL
  4. Results are posted as GitHub commit status (if configured)

Supported Platforms

PlatformWebhook URLEvent
Vercel/api/v1/webhooks/vercel/:projectIddeployment.succeeded
Netlify/api/v1/webhooks/netlify/:projectIddeploy_succeeded
GitLab/api/v1/webhooks/gitlab/:projectIdDeployment Hook

Setup

Vercel

  1. Go to Project → Integrations → Vercel
  2. Enable the integration and set your Vercel Project ID
  3. In Vercel: Settings → Webhooks → Add, paste the webhook URL
  4. Select event: deployment.succeeded

Netlify

  1. Go to Project → Integrations → Netlify
  2. In Netlify: Site settings → Build & deploy → Deploy notifications → Outgoing webhook
  3. Event: Deploy succeeded. URL: your AegisRunner webhook URL

GitLab

  1. Go to Project → Integrations → GitLab
  2. In GitLab: Settings → Webhooks → Add, paste the webhook URL
  3. Select: Deployment events

What Happens on Deploy

AegisRunner runs tests from the latest crawl against the deployment URL. If CI crawl pages are configured, those specific pages are crawled first. Results are posted as GitHub commit status if GitHub integration is enabled.

Preview Deployments

For preview/staging deploys, tests run against the preview URL automatically. Only preview deploys trigger tests (production deploys are skipped by default for Vercel).

Need help?

Can't find what you're looking for? Our support team is here to help.