---
title: "Update count preference of a channel"
method: PUT
path: "/v3/users/{user_id}/count_preference/{channel_url}"
tags: ["User"]
---

# Update count preference of a channel

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

## Request

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

## Update count preference of a channel

This action updates a user's count preference of a specific group channel. The count preference allows a user to either update the number of unread messages or the number of unread mentioned messages, or both in a specific group channel.

If you want to retrieve the total number count of a specific group channel, go to the [get count preference of a channel](https://sendbird.com/docs/chat/platform-api/v3/user/managing-unread-count/get-count-preference-of-a-channel) page.

https://sendbird.com/docs/chat/platform-api/v3/user/managing-unread-count/update-count-preference-of-a-channel#1-update-count-preference-of-a-channel

## Path parameters

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

## Headers

- `api-token` string

## Request body

- UpdateCountPreferenceOfAChannelRequest
  - `count_preference` 'false' | 'all' | 'unread_message_count_only' | 'unread_mentioned_count_only', required

## Response `200`

Successful response

- UpdateCountPreferenceOfChannelByUrlResponse
  - `count_preference` 'false' | 'all' | 'unread_message_count_only' | 'unread_mentioned_count_only'

## Changes

- **2025-07-27** `7a85bad03e90`: 1 breaking, 5 warning, 6 info
  - request property `count_preference` was restricted to a list of enum values
  - deleted the `header` request parameter `Api-Token`
  - added the new `all` enum value to the `count_preference` response property for the response status `200`
  - added the new `false` enum value to the `count_preference` response property for the response status `200`
  - …8 more
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **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/count_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)