Dashboard Guide#

The bzzz dashboard at app.bzzz.sh is where you manage your organization, send notifications, and monitor subscribers.

Getting started#

After signing up at bzzz.sh/register, you go through a 3-step onboarding:

1. Brand setup: upload your logo or pick a brand color, set visibility (public or private)
2. API keys: your first live and test keys are generated automatically
3. Integration preview: a ready-to-use curl example with your actual key

Overview#

The overview page shows:

• Total subscribers: how many devices are subscribed to your org
• Notifications sent: total notifications sent
• Active segments: how many segments you have
• Recent notifications: your last 5 sends with recipient counts

Sending notifications#

You can send notifications two ways:

From the dashboard#

Click "Send notification" from Overview or the Notifications page. Fill in:

• Title (optional): the bold headline
• Body (required): the main message
• URL (optional): where the notification links to when tapped
• Target: all subscribers, a specific external ID, or a segment

From your backend#

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

See the Send Notification API reference for full details.

Managing subscribers#

The Subscribers page shows all devices subscribed to your org with:

• Platform (iOS or macOS)
• External ID (if set during subscription)
• Subscription date

You cannot manually add subscribers. Users subscribe through the bzzz iOS app.

Segments#

Segments group subscribers by external ID for targeted sends. Create them from the Segments page:

1. Click "New segment"
2. Enter a name
3. Paste external IDs (comma-separated or one per line)

Then target a segment when sending: select "Segment" as the target and pick from the dropdown.

Settings#

General#

Organization name, URL slug, description, website, visibility (public/private), appearance (light/dark/system), and password change.

Branding#

Upload a logo (drag and drop, max 2MB, square works best) or set a brand color. The logo takes priority when set. Includes a live iOS notification preview.

API Keys#

Generate live or test keys. Live keys send real notifications. Test keys send to at most 1 device and skip logging. Keys are shown once at creation.

Team#

Invite members by email with a role:

• Owner: full access, cannot be removed if last owner
• Admin: everything except ownership transfer
• Viewer: read-only access

Plan#

View your current plan, upgrade or downgrade, switch between monthly and yearly billing. Manage your subscription through the Stripe billing portal.

Danger Zone#

Delete your organization permanently. Requires typing the org name to confirm.