DEV Community

Shib™ 🚀
Shib™ 🚀

Posted on • Originally published at apistatuscheck.com

How to Set Up API Outage Notifications in 5 Minutes

Your app depends on third-party APIs. When they go down, you need to know immediately — not 30 minutes later when your users start complaining on Twitter.

Here's how to set up instant outage notifications for any API in under 5 minutes, completely free.

Why You Need API Outage Alerts

Most teams monitor their own infrastructure but completely ignore third-party dependencies. Then this happens:

  1. Stripe's API starts returning 500 errors
  2. Your checkout flow breaks
  3. Your monitoring shows YOUR servers are fine
  4. You spend an hour debugging perfectly working code
  5. Someone checks Twitter and discovers Stripe has been down for 45 minutes

Sound familiar?

Option 1: Discord Webhook (2 min setup)

  1. Open Discord → Server Settings → Integrations → Webhooks
  2. Click New Webhook, name it "API Alerts"
  3. Copy the webhook URL
  4. Go to apistatuscheck.com and register it

You'll get messages like:

🔴 OUTAGE: OpenAI API
Status: operational → major outage
Check: https://apistatuscheck.com/api/openai

🟢 RECOVERY: OpenAI API  
Duration: 47 minutes
Enter fullscreen mode Exit fullscreen mode

Option 2: Slack Webhook (3 min setup)

  1. Go to api.slack.com/apps
  2. Create app → Enable Incoming Webhooks
  3. Add webhook to your #api-alerts channel
  4. Register at apistatuscheck.com

Option 3: RSS Feed (Works with anything)

https://apistatuscheck.com/feed.xml
Enter fullscreen mode Exit fullscreen mode

Works with Slack's built-in RSS, Zapier, IFTTT, email clients — anything that reads RSS.

Slack built-in:

/feed subscribe https://apistatuscheck.com/feed.xml
Enter fullscreen mode Exit fullscreen mode

Option 4: JSON API (Custom integrations)

curl https://apistatuscheck.com/api/status/openai
Enter fullscreen mode Exit fullscreen mode

Build it into your app:

async function checkDependency(apiName) {
  const res = await fetch(
    `https://apistatuscheck.com/api/status/${apiName}`
  );
  const data = await res.json();

  if (data.status !== 'operational') {
    console.warn(`⚠️ ${apiName} is ${data.status}`);
    return false;
  }
  return true;
}

// Before calling OpenAI
if (await checkDependency('openai')) {
  // Proceed with API call
} else {
  // Use fallback provider
}
Enter fullscreen mode Exit fullscreen mode

Or a pre-deploy gate:

# Don't deploy if critical APIs are down
STATUS=$(curl -s https://apistatuscheck.com/api/status/stripe | jq -r '.status')
if [ "$STATUS" != "operational" ]; then
  echo "❌ Stripe is down — skipping deploy"
  exit 1
fi
Enter fullscreen mode Exit fullscreen mode

Option 5: Status Badges (Passive monitoring)

Drop these in your README:

![OpenAI](https://apistatuscheck.com/api/badge/openai)
![Stripe](https://apistatuscheck.com/api/badge/stripe)
![AWS](https://apistatuscheck.com/api/badge/aws)
Enter fullscreen mode Exit fullscreen mode

Which Should You Pick?

Method Best For Setup Real-time?
Discord webhook Dev teams 2 min
Slack webhook Slack teams 3 min
RSS feed Any tool 1 min ⚠️ Varies
JSON API Custom 10 min
Status badges Visibility 1 min

Start with Discord/Slack webhook + README badges. Push alerts AND passive visibility.

100+ APIs Monitored

  • AI/ML: OpenAI, Anthropic, Gemini, Hugging Face
  • Payments: Stripe, PayPal, Square, Plaid
  • Cloud: AWS, GCP, Azure, Vercel, Cloudflare
  • Communication: Twilio, SendGrid, Slack, Discord
  • Dev Tools: GitHub, GitLab, Bitbucket, Jira, Linear
  • Databases: MongoDB, Supabase, PlanetScale, Firebase
  • Full list →

Get Started

  1. Bookmark apistatuscheck.com
  2. Set up one notification method
  3. Add badges to your README
  4. Stop debugging other people's outages

Total setup time: Under 5 minutes. Total cost: $0.


API Status Check monitors 100+ APIs in real-time. Free forever.

Top comments (1)

Collapse
 
martijn_assie_12a2d3b1833 profile image
Martijn Assie

Nice guide!! Tip, combine Discord or Slack webhooks with README badges, real-time alerts plus passive visibility keeps you ahead of outages!!