API Documentation

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Use your Server Key (sk_proj_...) for sending notifications.

Use your Client Key (pk_proj_...) for registering subscriptions.

Create a new project. Returns project ID and API keys.

List all projects for your account.

{
  "user_id": "user123",
  "endpoint": "https://fcm.googleapis.com/...",
  "p256dh": "base64-encoded-key",
  "auth": "base64-encoded-auth"
}

Send a notification to a specific user.

{
  "user_id": "user123",
  "title": "Hello!",
  "body": "Your notification message",
  "url": "https://example.com/page"  // optional
}

Send a notification to all subscribers in the project.

{
  "title": "Announcement",
  "body": "Message for everyone"
}