Skip to main content
Hosting

Get notified on your phone when Vercel deploys fail

Hugin Alerts sends you a push notification within seconds of a Vercel deploy failure or build timeout. Know your site is down before your users do — no dashboard checking required.

Last updated:

What you can monitor with Vercel

Deployment succeeded
Deployment failed or errored
Build failures and timeouts
Domain configuration issues
Project environment changes
Serverless function errors

Setup guide

Get started in minutes

1

How Vercel notifications work

Vercel can send outgoing webhooks when deploys succeed or fail. You can also run a post-build script that fires an HTTP request after every build. Either way, you need a URL that actually does something with the notification — like sending it to your phone.

2

Get a webhook URL from Hugin Alerts

Hugin Alerts is a small service that receives HTTP requests and turns them into push notifications on your phone. Install the app and tap "Get started" to get your unique ingest key. No account, no email, no credit card.

3

Set up a post-build notification script

The simplest approach is a small script that runs after your Vercel build. Add it to your project and reference it in your build command.

json
# In your package.json, chain the notification after your build:
{
  "scripts": {
    "build": "next build",
    "postbuild": "node notify-hugin.mjs"
  }
}
4

Create the notification script

This script checks if the build is a production deploy and sends the result to Hugin Alerts.

javascript
// notify-hugin.mjs
const HUGIN_KEY = process.env.HUGIN_KEY;
const VERCEL_ENV = process.env.VERCEL_ENV || 'preview';
const VERCEL_URL = process.env.VERCEL_URL || 'unknown';
const VERCEL_GIT_COMMIT_SHA = process.env.VERCEL_GIT_COMMIT_SHA || '';

if (HUGIN_KEY && VERCEL_ENV === 'production') {
  await fetch('https://api.huginalerts.com/v1/events', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${HUGIN_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      system: 'vercel',
      event: 'deploy_success',
      description: `Deployed to production — ${VERCEL_URL} (${VERCEL_GIT_COMMIT_SHA.slice(0, 7)})`,
    }),
  });
}

Examples

Ready-to-use examples

Deployment success notification

Get notified when your production deployment goes live.

bash
curl -X POST https://api.huginalerts.com/v1/events \
  -H "Authorization: Bearer YOUR_INGEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system": "vercel",
    "event": "deploy_success",
    "description": "Deployed to production — myapp.vercel.app (abc1234)"
  }'

Build failure notification

Know immediately when your Vercel build breaks.

bash
curl -X POST https://api.huginalerts.com/v1/events \
  -H "Authorization: Bearer YOUR_INGEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system": "vercel",
    "event": "build_failed",
    "description": "Build failed — Type error in src/pages/index.tsx line 42"
  }'

Domain issue notification

Get alerted when a domain configuration needs attention.

bash
curl -X POST https://api.huginalerts.com/v1/events \
  -H "Authorization: Bearer YOUR_INGEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system": "vercel",
    "event": "domain_error",
    "description": "SSL certificate renewal failed for myapp.com"
  }'

Frequently asked questions

How do I get push notifications when my Vercel deployment fails?
Use Hugin Alerts. Add a postbuild script to your project that sends an HTTP request to the Hugin API. When a build completes or fails, you get an instant push notification on your iPhone or Android device. Setup takes under 60 seconds — no account required.
Does this work with Next.js, Nuxt, and other frameworks?
Yes, this approach is framework-agnostic. It works with any project hosted on Vercel — Next.js, Nuxt, SvelteKit, Astro, Remix, or plain static sites. The notification is just a standard HTTP request that runs after your build step.
Can I only get notified for production deployments?
Yes. Check the VERCEL_ENV environment variable in your script and only send notifications when it equals 'production'. The example script above already does this — preview and development deploys are silently skipped.
How do I add the Hugin key as an environment variable in Vercel?
In the Vercel dashboard, go to Project Settings → Environment Variables → Add HUGIN_KEY with your ingest key. Make sure it's available for the Production environment. The key is never exposed to the browser — it only runs server-side during the build.
Can I get notified about build failures, not just successes?
The postbuild script only runs after a successful build. To catch build failures, use Vercel's outgoing webhooks (Project Settings → Webhooks) which fire on deployment status changes including errors. Point them at a small proxy that forwards to the Hugin API.
How fast are the notifications?
Hugin Alerts delivers push notifications within seconds of receiving the HTTP request. Combined with Vercel's build pipeline, you'll typically know about a deployment result within moments of it completing.
What is Hugin Alerts?
Hugin Alerts is a push notification service for developers. Send one HTTP request from any system — Vercel builds, CI/CD, cron jobs, scripts — and get an instant push notification on your phone. No sign-up, no email, no credit card. Free during early access.

Start getting Vercel alerts now

Set up takes less than a minute. No sign-up, no email, no credit card.

Get started for free