Vercat
Download

How to get notified when a Vercel deployment fails

Every way to hear about failed and finished Vercel deployments: email, browser push, webhooks, and a phone app. What each covers and which plan it needs.

Updated

A deploy fails while you are away from your desk. The question is how quickly you find out, and whether the alert reaches you somewhere you will actually see it. Vercel gives you four options, and each one fits a different team.

The quick answer

OptionReaches you viaPlanSetup
Vercel emailInboxAll plansNone
Vercel web pushBrowser notificationAll plansAllow per device
WebhooksYour own endpointPro and EnterpriseWrite a receiver
VercatNative push and Live ActivitiesPro and Enterprise teamsToggle in the app

1. Vercel’s built-in notifications

Vercel has a notifications page in your account settings. Under Deployments you will find Deployment Failures and Deployment Ready. Each can be delivered on the web (the bell in the dashboard), by email, or as a push notification.

Two things trip people up. Failure alerts go to the person who created the deployment, so a teammate’s broken push will not reach you by default. And push here means web push: on a phone you open the dashboard in the browser and allow notifications, which works but is easy to lose among other browser alerts.

2. Webhooks to Slack or your own service

On Pro and Enterprise teams you can create account webhooks. Vercel sends a signed POST request for events such as deployment.error, deployment.succeeded, deployment.canceled and deployment.promoted. Each request carries an x-vercel-signature header, an HMAC-SHA1 of the raw body, so your receiver can check it came from Vercel.

{
  "type": "deployment.error",
  "id": "...",
  "createdAt": 1762838400000,
  "payload": { "deployment": { "id": "...", "url": "..." } }
}

This is the most flexible option and the most work: you host the endpoint, verify the signature, and decide where the message goes.

3. Native push on your phone with Vercat

Vercat is an independent Vercel app for iPhone and Android. Turn on notifications for a team and it creates the webhook with your token, then sends you a native push when a deployment fails, succeeds or is promoted. You pick which of those you want. On iPhone, a Live Activity can follow a build on the Lock Screen until it finishes.

Tapping the notification opens that deployment, with its build logs and the buttons to redeploy or roll back. Because it uses webhooks, notifications need a Pro or Enterprise team.

Which one should you use?

FAQ

Does Vercel email me when a deployment fails?

Yes. Deployment Failures is one of Vercel’s notification types, and email is one of its channels. By default it goes to the person who created the deployment.

Can I get Vercel push notifications on my phone?

Vercel supports web push in desktop and mobile browsers: open the dashboard in your phone’s browser and allow notifications. For native iOS or Android notifications you need a third-party app such as Vercat.

Which webhook events cover deployments?

deployment.created, deployment.succeeded, deployment.error, deployment.canceled, deployment.promoted and deployment.rollback. Account webhooks are available on Pro and Enterprise.

Do Vercat notifications work on the Hobby plan?

No. Vercat’s push notifications are built on Vercel webhooks, which Vercel only offers on Pro and Enterprise teams. Everything else in the app works on Hobby.

Vercel, in your pocket.

Push alerts, logs, rollbacks and usage for every project. 7-day free trial for eligible subscribers.