Documentation

Everything you need to get the most out of Pulse

Guides, references, and explanations for monitoring your APIs with Pulse.

01 · Getting Started

Getting Started

Pulse is a lightweight uptime and response monitoring tool for developers. Add your API endpoints, and Pulse pings them on a schedule — alerting you instantly when something goes down or recovers.

There's nothing to install. Everything runs in the browser and through our hosted worker. You'll be monitoring your first endpoint in under a minute.

How it works

  1. 01Sign up for free — no credit card required
  2. 02Add your first endpoint — give it a name, URL, HTTP method, and expected status code
  3. 03Pulse pings it every 5 minutes automatically from our worker
  4. 04Get notified instantly via push notification or webhook if it goes down

Free tier limits

Up to 5 monitors

Add up to 5 endpoints on the free plan

5-minute check interval

Pulse pings every 5 minutes

7-day ping history

Uptime bars and ping logs show the last 7 days

Browser push notifications

Get notified in your browser on status change

Webhooks

POST to any URL including Discord on status change

Public status page

Share a live status page with your users

02 · Monitors

Monitors

A monitor is an endpoint Pulse regularly pings to check if it's responding as expected. Each monitor tracks a single URL and reports its status, response time, and uptime history.

Adding a monitor

Click Add Monitor on the dashboard. Fill in:

NameA human-readable label, e.g. Production API
URLThe full URL to ping, e.g. https://api.example.com/health
MethodGET, POST, or HEAD — defaults to GET
Expected status codeThe HTTP status your endpoint returns when healthy (usually 200)
Check intervalMinimum 5 minutes on the free tier
Webhook URLOptional — Pulse will POST here on status change

Click Save — Pulse starts monitoring immediately on the next cron cycle.

Editing a monitor

Click the Edit link on any monitor row (visible on hover on desktop, always visible on mobile). You can update any field including the webhook URL. Changes take effect on the next ping cycle.

Pausing a monitor

Click Pause on any monitor row to stop pinging it. No alerts will fire while paused, and the monitor will disappear from your public status page. Resume anytime with Resume.

Monitor detail page

Click any monitor name to open its detail page. Here you can:

  • View the 7-day uptime bar with daily breakdown
  • See full ping history with status codes and response times
  • Review the incidents log (every status change)
  • Trigger an immediate manual ping with Check Now

03 · Notifications

Notifications

Pulse sends browser push notifications the moment a monitor changes status — no app required, no email setup needed.

Enabling push notifications

  1. 01Click the bell icon 🔔 in the dashboard header
  2. 02Click Allow when your browser prompts for notification permission
  3. 03You'll receive a system notification when any monitor goes down or recovers

Browser support

Chrome
Edge
Firefox
Android Chrome
iOS Safari
Safari (macOS)Partial

Re-enabling blocked notifications

If you accidentally blocked notifications, go to your browser settings → Site permissions → Notifications → find this site → change to Allow. Then click the bell icon again to re-subscribe.

04 · Webhooks

Webhooks

A webhook is a URL on your server or a third-party service that Pulse will POST to whenever a monitor changes status. One webhook URL per monitor.

Adding a webhook

When adding or editing a monitor, paste a URL into the optional Webhook URL field. Pulse will POST to that URL on every status change — both when a monitor goes down and when it recovers.

Discord webhooks

Pulse auto-detects Discord webhook URLs and sends a formatted embed message instead of a raw JSON body.

  1. 01Open your Discord server
  2. 02Go to channel settings → Integrations → Webhooks
  3. 03Create a new webhook and copy the URL
  4. 04Paste the URL into the Webhook URL field on any monitor

You'll get a red embed when a monitor goes down and a green embed when it recovers.

Generic webhooks

For Slack incoming webhooks, custom servers, Zapier, Make, or any other service, Pulse sends a JSON body:

{
  "monitor_id": "uuid",
  "monitor_name": "My API",
  "monitor_url": "https://api.example.com",
  "type": "down" | "recovered",
  "timestamp": "2026-01-01T00:00:00.000Z"
}

Notes

  • ·One webhook URL per monitor
  • ·Webhook failures are logged but do not affect monitoring or alerts
  • ·Webhooks fire on every status change — both down and recovered

05 · Status Pages

Status Pages

Every Pulse account comes with a public status page — a live URL you can share with your users, clients, or team. No login required to view it.

Finding your status page URL

On the dashboard, scroll down to the Share status page section. Your URL looks like:

/status/[your-user-id]

Click the copy button next to the URL to copy it to your clipboard.

What the status page shows

  • Overall system status banner — All systems operational, Degraded, or Outage
  • Each active monitor with name, current status indicator, and uptime %
  • A 7-day uptime bar (4 segments per day showing 6-hour windows)
  • Auto-refreshes every 60 seconds

Notes

  • ·Paused monitors do not appear on the status page
  • ·No login or account required to view a status page
  • ·The status page is publicly indexed — share the URL freely

06 · Coming Soon

What's Coming in V2

These features are planned for upcoming releases. The free tier stays free.

Email alerts

Get notified by email when a monitor goes down or recovers. Requires custom domain setup.

Unlimited monitors

Pro tier removes the 5-monitor limit so you can monitor everything.

1-minute check intervals

Pro tier enables more frequent pinging for critical endpoints.

30 and 90 day history

Longer ping history retention for trend analysis and reporting.

SSL certificate monitoring

Get alerted before your SSL certificate expires so you never go dark.

Custom status page domain

Use your own domain for your status page instead of the default URL.

CSV export

Export your full ping history as a CSV for analysis or reporting.

Account & billing page

Manage your subscription, payment details, and account settings.

Have a feature request? We'd love to hear it. Send us a message.