---
title: "Update push preferences for a channel"
method: PUT
path: "/v3/users/{user_id}/push_preference/{channel_url}"
tags: ["User"]
---

# Update push preferences for a channel

`PUT /v3/users/{user_id}/push_preference/{channel_url}`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/users/{user_id}/push_preference/{channel_url}`
- Auth: none declared

## Update push preferences for a channel

You can update a user's notifications preferences for a specific channel. A push notification is a message that is immediately delivered to a user's device when the device is either idle or running the client app in the background.

> **Note**: Push notifications are only available for group channels. 
  

[https://sendbird.com/docs/chat/platform-api/v3/user/configuring-notification-preferences/update-push-notification-preferences-for-a-channel#1-update-push-notification-preferences-for-a-channel](https://sendbird.com/docs/chat/platform-api/v3/user/configuring-notification-preferences/update-push-notification-preferences-for-a-channel#1-update-push-notification-preferences-for-a-channel)

## Path parameters

- `user_id` string, required
- `channel_url` string, required

## Headers

- `api-token` string

## Request body

- UpdatePushPreferencesForAChannelRequest
  - `push_trigger_option` 'default' | 'all' | 'mention_only' | 'false', required: The type of notifications trigger applies to group channels when a user is disconnected from Sendbird server. Acceptable values are the following: - default (default): Indicates that a user's notifications trigger setting applies to the specified channel. - all: Indicates that a user receives notifications for all new messages. - mention_only: Indicates that a user only receives notifications for mentioned messages. - off: Indicates that a user doesn't receive any notifications.
  - `push_sound` string

## Response `200`

Successful response

- UpdatePushPreferencesForAChannelResponse
  - `enable` boolean
  - `push_sound` string
  - `push_trigger_option` 'all' | 'mention_only' | 'off'

## Changes

- **2025-07-27** `073cffd0bd87`: 1 info
  - removed the `default` enum value from the `push_trigger_option` response property for the response status `200`
- **2025-07-27** `7a85bad03e90`: 1 breaking, 15 warning, 7 info
  - request property `push_trigger_option` was restricted to a list of enum values
  - deleted the `header` request parameter `Api-Token`
  - removed the request property `enable`
  - removed the optional property `do_not_disturb` from the response with the `200` status
  - …19 more
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-05-03** `5299c01f7f16`: 1 info
  - added the optional property `enable` to the response with the `200` status
- **2022-02-16** `c42164095c7c`: 1 breaking
  - the `header` request parameter `Api-Token` became required

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/users/:user_id/push_preference/:channel_url/put.md)

---

[API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [All operations](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/revisions/9e53a5288df0?raw)