Public API

Send notifications, look up subscribers and report events from your own backend.

Authentication

Each website or app has a secret API key in the panel (visible to Owners and Admins). Send it in the X-Api-Key header from your server only, never from a browser or app.

Send a notification

curl -X POST https://notizop.com/v1/api/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Order shipped",
    "body": "Your order #1234 is on the way",
    "deepLink": "https://example.com/orders/1234",
    "target": { "type": "users", "userIds": ["user-123"] }
  }'

Only title, body and target are required. target.type is one of all, segment, users, tags, tokens or installations. Add imageUrl, actions or a future scheduledAt as needed. The answer is 201 with the notification.

Other endpoints

Endpoint	What it does
`GET /v1/api/notifications/{id}`	A notification with its delivery stats
`GET /v1/api/devices?userId=…`	The subscriptions of one of your users
`POST /v1/api/events`	Report custom events (up to 100 per request) for segments and conversions

{ "events": [ { "name": "purchase_completed", "userId": "user-123", "properties": { "cart_total": 2499 } } ] }

Get your API key free All guides