---
title: "Register a Live Activity push token"
method: POST
path: "/v1/live-activities"
tags: ["live-activities"]
---

# Register a Live Activity push token

`POST /v1/live-activities`

## Request

- Base URL: `https://api.getmyhotels.com`
- URL: `https://api.getmyhotels.com/v1/live-activities`
- Auth: HTTP bearer

Runs `liveActivity.register`. Idempotent per token — a device re-registers on every launch and after every token rotation, so this upserts rather than inserts.

## Request body

- object
  - `kind` 'start' | 'update', required
  - `pushToken` string, required
  - `bookingPublicId` string, nullable
  - `activityId` string, nullable
  - `environment` 'production' | 'development'

## Response `200`

Success

- unknown

## Other responses

- `400`: Request validation failed or the router rejected the input
- `401`: Missing or invalid bearer session token
- `426`: Reported X-GMH-App-Version is below the supported minimum — the app must update
- `500`: Unexpected server error (opaque; details stay in logs)

---

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