Push notifications

Prerequisites

• A Meridian project with an active API key
• At least one registered device token per target user
• VAPID keys configured in your project settings for web push

Step 1 — Register a device

Collect the platform-specific push token from your client app and send it to the registration endpoint.

POST /v1/devices
{
  "token": "fcm-token-or-apns-token",
  "platform": "ios",
  "user_id": "usr_abc123"
}

Step 2 — Send a notification

Use the notifications endpoint to target specific users or broadcast to all subscribers.

POST /v1/notifications
{
  "user_ids": ["usr_abc123"],
  "title": "New feature",
  "body": "Dark mode is here.",
  "click_url": "https://app.example.com/settings"
}

Delivery status

Poll the notification status endpoint to confirm delivery or inspect failures per device.

GET /v1/notifications/ntf_xyz789/status