Push Notifications

Push notification token management

Register a token for push notifications

post

https://network.ruuvi.comhttps://testnet.ruuvi.com

/push-register

Registers a push notification token for the authenticated user. The type of the token determines the handler used to send notifications. Currently supported types are iOS and Android, but other values are allowed for future compatibility. Both Android and iOS handlers use params to define the language of the notifications, default "en". Supported languages as of 2025-11 are English (en), Finnish (fi), Swedish (sv), French (fr), Russian (ru), and German (de). Rate limits apply per user account, IP address and total calls.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

tokenstringRequired

Push notification token, used to authenticate at the push notification services

Example: [email protected]

typestring · enumRequired

Device platform type

Example: iOSPossible values:

namestringRequired

Human-readable device name

Example: Otso's mobile phone 2

Responses

200

Push notification token registered successfully

application/json

400

INVALID - Missing or malformed fields (token, type, or name missing; invalid type value)

application/json

401

UNAUTHORIZED - Auth token missing

application/json

403

FORBIDDEN - User does not have permission to register push tokens

application/json

429

Too many requests - Rate limit exceeded Rate limits apply per user account, IP address and total calls. Try again later.

application/json

post

/push-register

HTTPcURLJavaScriptPython

POST /push-register HTTP/1.1
Host: network.ruuvi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "name": "Google Pixel 7",
  "params": {
    "language": "en"
  },
  "token": "dWD8xlZKS7y...******...rpeM",
  "type": "Android"
}

androidios

{
  "result": "success",
  "data": {
    "id": 6037729964,
    "lastAccessed": 1763900053,
    "name": "Otso's mobile phone 2"
  }
}