Documentation
Pinglet turns a single HTTP request into a native push notification. POST a message to a topic and every subscribed device gets an alert. No account needed to receive.
Getting started →
Publish your first push notification in under five minutes: mint a key, send one curl, and subscribe on your phone.
Start here
Core concepts
Publishing
The two publish endpoints, how authentication works, and what the response tells you.
Message anatomy
Every field a published message can carry (title, priority, level, badges and metadata) and the limits that apply.
Subscribing & the app
How devices subscribe with a link or QR code, browse history, and follow topics live; no account needed.
Guides
Generic webhook
Hook up any tool that can send an HTTP request. The universal integration that needs no plugin, SDK or support from the other side.
Apprise
Pinglet is a native Apprise service. One pinglets:// URL adds push notifications to every tool that embeds Apprise.
Gatus
Send Gatus health-check alerts to a Pinglet topic with the custom alerting provider, triggered and resolved states included.
GitHub Actions
Push deploy results and CI failures to your phone with the Pinglet Notify action, or a single curl step.
Heartbeats
Get alerted when something stops happening (backups, cron jobs, servers) with one GET request on a schedule.
Home Assistant
Send Home Assistant automations to your phone as Pinglet push, with RESTful notify for the simple case and rest_command for full control.
Komodo
Soon
Komodo alerts as native push. Pinglet's side is live; waiting on upstream Komodo support for auth headers.
Prometheus Alertmanager
Point an Alertmanager webhook receiver at a Pinglet topic and get your Prometheus alerts as native push.
Proxmox VE
Point a Proxmox VE webhook notification target at a Pinglet topic to get backup results, replication failures and node alerts as native push.
Uptime Kuma
Uptime Kuma has a native Pinglet notification provider. Pick Pinglet from the list, paste your topic URL and key, done.
Reference