---
title: "Register a push notification subscription"
method: POST
path: "/api/push-subscription"
tags: ["Push"]
---

# Register a push notification subscription

`POST /api/push-subscription`

## Request

- Base URL: `https://movementors.com`
- URL: `https://movementors.com/api/push-subscription`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `authjs.session-token`

Two body shapes: mobile (Expo) or web (Web Push). The platform field discriminates.

## Request body

- union
  - object
    - `platform` 'IOS' | 'ANDROID', required
    - `expoPushToken` string, required
    - `device` string
    - `userAgent` string
  - object
    - `subscription` object, required
      - `endpoint` string, uri, required
      - `keys` object, required
        - `p256dh` string, required
        - `auth` string, required
    - `userAgent` string

## Response `200`

Subscription registered

- object
  - `success` boolean, required
  - `subscriptionId` string, required

---

[API](https://skmtc.dev/movementors/apis/movementors-api.md) · [All operations](https://skmtc.dev/movementors/apis/movementors-api/llms.txt) · [OpenAPI document](https://skmtc.dev/movementors/apis/movementors-api/revisions/042fb6b44679?raw)