Getting started
From zero to your first push in under a minute.
stdpush delivers private push notifications from scripts, servers, CI pipelines and AI agents. One authenticated HTTP request is the whole integration — everything else in these docs is convenience.
Five steps
- Create an account — email/password or GitHub.
- Create a project. Every project starts with a private
defaulttopic. - Create an API key in the project's API keys tab. It's shown exactly
once — export it as
STDPUSH_API_KEY. - Register a device. The iOS app is on its way to TestFlight; today you can register a mock device from the dashboard to see the full delivery pipeline work.
- Send your first notification:
curl -X POST https://api.stdpush.com/v1/notify \
-H "Authorization: Bearer std_live_..." \
-d '{"title": "Hello from my terminal"}'The API answers 202 Accepted and delivery happens asynchronously — check
the notification's per-device status in the dashboard.
Prefer a command?
npm install -g stdpush gives you stdpush "Hello" and a browser-based
login — see the CLI guide.