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

# Update push preferences

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

## Request

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

## Update push preferences

You can update a user's notifications preferences. 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#1-update-push-notification-preferences](https://sendbird.com/docs/chat/platform-api/v3/user/configuring-notification-preferences/update-push-notification-preferences#1-update-push-notification-preferences)

## Path parameters

- `user_id` string, required

## Headers

- `api-token` string

## Request body

- UpdatePushPreferencesRequest
  - `block_push_from_bots` boolean
  - `do_not_disturb` boolean
  - `enable_push_for_replies` boolean
  - `end_hour` integer
  - `end_min` integer
  - `push_blocked_bot_ids` string[]
  - `push_sound` string
  - `push_trigger_option` 'all' | 'mention_only' | 'off'
  - `snooze_enabled` boolean
  - `snooze_end_ts` integer
  - `snooze_start_ts` integer
  - `start_hour` integer
  - `start_min` integer
  - `timezone` string
  - `dnd_schedules` UpdatePushPreferencesRequestDndSchedulesInner[]
    - `day_of_week` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday'
    - `time_windows` UpdatePushPreferencesRequestDndSchedulesInnerTimeWindowsInner[]
      - `start_hour` integer
      - `start_min` integer
      - `end_hour` integer
      - `end_min` integer

## Response `200`

Successful response

- UpdatePushPreferencesResponse
  - `block_push_from_bots` boolean
  - `do_not_disturb` boolean
  - `enable_push_for_replies` boolean
  - `end_hour` integer
  - `end_min` integer
  - `push_blocked_bot_ids` string[]
  - `push_sound` string
  - `push_trigger_option` 'all' | 'mention_only' | 'off'
  - `snooze_enabled` boolean
  - `snooze_end_ts` integer
  - `snooze_start_ts` integer
  - `start_hour` integer
  - `start_min` integer
  - `timezone` string
  - `dnd_schedules` UpdatePushPreferencesRequestDndSchedulesInner[]
    - `day_of_week` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday'
    - `time_windows` UpdatePushPreferencesRequestDndSchedulesInnerTimeWindowsInner[]
      - `start_hour` integer
      - `start_min` integer
      - `end_hour` integer
      - `end_min` integer

## Changes

- **2026-03-30** `9e53a5288df0`: 2 info
  - added the new optional request property `dnd_schedules`
  - added the optional property `dnd_schedules` to the response with the `200` status
- **2025-07-27** `073cffd0bd87`: 1 breaking, 1 info
  - removed the enum value `default` of the request property `push_trigger_option`
  - removed the `default` enum value from the `push_trigger_option` response property for the response status `200`
- **2025-07-27** `7a85bad03e90`: 3 breaking, 5 warning, 17 info
  - request property `push_trigger_option` was restricted to a list of enum values
  - the `snooze_end_ts` request property format changed from no format to `int64`
  - the `snooze_start_ts` request property format changed from no format to `int64`
  - deleted the `header` request parameter `Api-Token`
  - …21 more
- **2024-02-15** `5f57124ed0b9`: 1 breaking, 2 info
  - the `push_blocked_bot_ids/items/` request property type changed from `integer` to `string`
  - the request property `block_push_from_bots` became optional
  - the request property `push_blocked_bot_ids` became optional
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/users/:user_id/push_preference/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)