---
title: "Subscribe a device to a channel"
method: POST
path: "/push/channelSubscriptions"
tags: ["Push"]
---

# Subscribe a device to a channel

`POST /push/channelSubscriptions`

Subscribe either a single device or all devices associated with a client ID to receive push notifications from messages sent to a channel.

## Request body

- union
  - object
    - `channel` string — Channel name.
    - `deviceId` string — Must be set when clientId is empty, cannot be used with clientId.
  - object
    - `channel` string — Channel name.
    - `clientId` string — Must be set when deviceId is empty, cannot be used with deviceId.

## Response `2XX`

OK

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/ably/apis/platform-api.md) · [All operations](https://skmtc.dev/ably/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ably/platform-api/revisions/d9cf7e90bb58/schema)