bzzz/docs

Quickstart

Send your first push notification in under 2 minutes.

1. Create your organization

Sign up at bzzz.sh/register. Pick a name, set your slug, and you're in.

2. Get your API key

After registration, the onboarding flow generates a live and test API key. Copy the live key. You'll only see it once.

You can also generate keys from Dashboard > Settings > API Keys.

3. Send a notification

bash
curl -X POST https://api.bzzz.sh/v1/notify \
  -H "Authorization: Bearer bzzz_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Hello from bzzz!",
    "body": "Your first push notification.",
    "target": "all"
  }'

That's it. Every subscriber to your organization gets a native iOS notification.

4. Target specific users

Instead of "all", you can target by external ID or segment:

json
{ "target": { "external_id": "usr_123" } }
json
{ "target": { "segment": "premium-users" } }

Next steps