Documentation

Authentication

SDK keys for client apps and REST keys for your backend.

API key types

TypeWhere it livesUse for
SDKMobile / web clientIdentify users, register tokens, tags, events
RESTYour server onlySend notifications, server-side admin

Sending credentials

Pass the key in any of these forms:

http
Authorization: Bearer ek_rest_...
Authorization: Basic ek_rest_...
X-Api-Key: ek_rest_...

Dashboard auth

The operator dashboard uses Firebase Google sign-in. Dashboard routes under /projects require a Firebase ID token — separate from project API keys.

Identity verification (SDK)

When enabled on a project, SDK user calls must include an HMAC-SHA256 of external_id using the project secret (server-side only). See Project settings → Security.

warning

Warning

Never embed REST keys or APNs/FCM secrets in a mobile app. SDK keys are scoped for client ingestion; they cannot send arbitrary broadcasts.