Push notifications

Notify users who are offline (no live WebSocket). Online users already get realtime events — you don’t need push for that.

New here?

Quick start → connect with a session token. Then register a device token.

Register from the client

After connect():

await client.registerDeviceToken({
  provider: "ONESIGNAL", // or FCM / PUSHY / APNS
  token: subscriptionIdFromSdk,
  platform: "ios",
});

Calls POST /users/me/device-tokens with the session token. No extra mint route required.

provider	Notes
ONESIGNAL	Use the OneSignal Subscription ID as token
FCM, PUSHY, APNS	Tokens stored; wire tenant app config via API Reference

Configure push providers on the account with your API key (/tenant-apps in the API reference).

Incoming calls while backgrounded

In-app ring = Socket.IO call-invite.
App killed / backgrounded = you push:

1. Handle webhook call.started.
2. Notify other participants (FCM / APNs / OneSignal).
3. On tap, open the room and accept / rejoin.

Sendsar does not auto-push call invites via device tokens.

Enable calls in the dashboard; client wiring is in Quick start (Calls step).

Next

• Webhooks
• Issue session tokens
• API Reference