Produl/ docs
DashboardPricing

Vercel

A two-way integration: Vercel deploy events auto-create annotations on your dashboards, and Produl pulls deployment metrics from the Vercel API.

What it does

The Vercel integration has two independent functions:

  1. Deploy annotations— Vercel sends a webhook to Produl whenever a deployment succeeds. Produl matches the deployment's URL or domain against your registered sites and creates a timeline annotation on every chart for that site. The annotation includes the commit message, deploy URL, and timestamp.
  2. Vercel Metrics widget — Produl calls the Vercel API on your behalf to fetch the last 10 deployments plus 30-day usage stats: bandwidth, edge request count, and function invocations. These appear as a dedicated widget in your dashboard.

Both functions use the same OAuth connection. You only need to connect once.

Setup

  1. 1

    Open Settings → Integrations

    Navigate to Settings → Integrations and click Connect Vercel.
  2. 2

    Authorize via Vercel OAuth

    You will be redirected to Vercel's OAuth authorization page. Select the Vercel scope (personal account or team) you want to connect and click Allow.
  3. 3

    Register the deploy webhook

    After connecting, configure Vercel to forward deployment events to Produl. In your Vercel project settings, go to Settings → Webhooks and add:
Vercel Webhook URLtext
https://app.produl.tech/api/webhooks/vercel-deploy

Set the event type to deployment.succeeded.

Domain matching

Produl matches incoming deploy events against your registered site domains. Make sure your Produl site domain matches the production URL or an alias in your Vercel deployment. If your site is example.com, set that as the domain in your Produl site settings.

What data is synced

Inbound: deploy annotations (Vercel → Produl)

When Vercel sends a deployment.succeeded event, Produl extracts:

  • Deploy URL and all production aliases
  • Commit message (from GitHub, GitLab, or Bitbucket metadata)
  • Deployment name and creation timestamp

A chart annotation is created for every Produl site whose domain matches one of the deployment's URLs or aliases. Annotations appear as vertical markers on all time-series charts for that site.

Outbound: Vercel API metrics (Produl → Vercel API)

The Vercel Metrics widget reads your deployments and usage from the Vercel API to display:

  • Last 10 deployments: name, state, URL, and creation time
  • 30-day bandwidth (bytes transferred)
  • 30-day edge request count
Usage stats (bandwidth and edge requests) are only available on Vercel Pro and Enterprise plans. The widget still shows deployment history on Hobby plans.

Permissions

You must be a project admin on the Vercel project to install the webhook. The OAuth access token Produl receives grants access to the scopes Vercel provides by default for third-party integrations (read deployments and usage data). Produl never creates, modifies, or deletes Vercel resources.

Troubleshooting

Annotations not appearing

First confirm the webhook is registered and Vercel is sending events by checking the webhook delivery log in your Vercel project (Settings → Webhooks → Recent deliveries). If deliveries are succeeding but annotations are missing, check that the deployment's production URL matches a Produl site domain exactly — including or excluding www matters.

Vercel Metrics widget shows an error

The widget fetches data at render time using your connected Vercel account. If the connection has expired or been revoked, disconnect and reconnect the Vercel integration from Settings → Integrations to re-authorize.

bash
# Manually test the webhook endpoint
curl -X POST https://app.produl.tech/api/webhooks/vercel-deploy \
  -H "Content-Type: application/json" \
  -d '{"type":"deployment.succeeded","payload":{"deployment":{"url":"example.com","name":"my-app"}}}'

Previous

Slack

Next

Neon