All integrations

Vercel deploys

Every deploy → phone. No code, no SDK.

LiveWebhooksigned URL
progress (amber-82) Live Activity preview
deploy in progress

Vercel's Deploy Hooks are project-scoped outbound webhooks that fire on every deployment event (`deployment.created`, `deployment.succeeded`, `deployment.error`, `deployment.canceled`). Chirp's @deploy schema turns the stream into one Live Activity per deploy - opens on `created`, closes on the first terminal event.

Preview deploys and production deploys both fire. The Chirp card distinguishes them with a small "PREVIEW" / "PROD" badge so you can ignore preview noise at a glance. Tap the card to open the deployment URL or the Vercel dashboard for the build.

Prerequisites

  • A Vercel project with at least one deployment.
  • A Chirp inspector / webhook URL.

Setup

  1. 1

    Open the project's Git settings

    Vercel dashboard → your project → Settings → Git → Deploy Hooks.

  2. 2

    Add a hook with the Chirp URL

    Click "Add Deploy Hook". Vercel actually has two webhook surfaces: "Deploy Hooks" (which TRIGGER deploys) and "Webhooks" (which RECEIVE deploy events). For Chirp, use **Webhooks** - Settings → Webhooks → Create Webhook → URL is your inspector.

    shell
    # Vercel → Project → Settings → Webhooks → Create:
URL: https://api.chirpapp.dev/v1/webhooks/vercel?key=YOUR_KEY
Events: deployment.created, deployment.succeeded,
        deployment.error, deployment.canceled
  3. 3

    (Optional) Org-wide hook

    Vercel → Team Settings → Webhooks. Same URL, fires for every project in the org. Useful for an inspector that aggregates all your deploys, but noisy if you have a lot of preview-PR activity.

What you’ll see

Card header: Vercel triangle logo + "Vercel · DEPLOYING" + project name + branch (`main`, `pr-42`). Action line shows commit message (truncated) and current build phase. PROD vs PREVIEW badge in the top-right. Closes green on `succeeded` with the deploy URL clickable; red on `error` with the build log URL.

Troubleshooting

I added a Deploy Hook but no events fire.
Deploy Hooks TRIGGER deploys; they don't receive events. You want **Webhooks** instead - Settings → Webhooks (different page than Deploy Hooks).
Card opens twice on every deploy.
Both an org-level webhook and a project-level webhook are pointing at the same Chirp key. Remove one. Project-level is preferred for granularity.
Preview deploys are too noisy - I only want production.
Vercel's Webhooks support per-event filters but not per-environment filters. Workaround: in Chirp's inspector settings, filter by target == "production" - Vercel includes the target in the payload.
Browse all integrations