Test Mode#

Test mode lets you safely integrate bzzz without sending real notifications to your subscribers.

How it works#

Generate a test API key from Dashboard > Settings > API Keys. Test keys have the prefix bzzz_test_.

When you use a test key:

• Notifications are sent to at most 1 device
• Nothing is logged to your notification history
• Rate limits still apply

When to use test mode#

• During initial integration and development
• In CI/CD pipelines to verify your API calls work
• When onboarding new team members

Switching to production#

Replace your test key with a live key (bzzz_live_). No other code changes needed. The request format is identical.

# Test
curl -X POST https://api.bzzz.sh/v1/notify \
  -H "Authorization: Bearer bzzz_test_abc123..." \
  -d '{ "body": "Test notification", "target": "all" }'

# Production (same request, different key)
curl -X POST https://api.bzzz.sh/v1/notify \
  -H "Authorization: Bearer bzzz_live_def456..." \
  -d '{ "body": "Real notification", "target": "all" }'