---
title: "Choose a push notification content template"
method: PUT
path: "/v3/users/{user_id}/push/template"
tags: ["User"]
---

# Choose a push notification content template

`PUT /v3/users/{user_id}/push/template`

## Request

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

## Choose a push notification content template

Users can choose a template to determine how push notifications appear to them. Push notification content templates are pre-formatted forms that can be customized to display your own push notification messages on a user's device. Sendbird provides two types: `default` and `alternative`. Go to **Settings** > **Chat** > **Push notifications** > **Push notification content templates** on [Sendbird Dashboard](https://dashboard.sendbird.com/auth/signin) to customize the templates.

If the `push_message_template` property is specified when [sending a message](https://sendbird.com/docs/chat/platform-api/v3/message/messaging-basics/send-a-message), the content template customized for the message takes precedence over the user's choice.

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

https://sendbird.com/docs/chat/platform-api/v3/user/configuring-notification-preferences/choose-a-push-notification-content-template#1-choose-a-push-notification-content-template

## Path parameters

- `user_id` string, required

## Headers

- `api-token` string

## Request body

- ChooseAPushNotificationContentTemplateRequest
  - `name` 'default' | 'alternative', required: Specifies the name of a template used for notifications. Acceptable values are default and alternative. (Default: default)

## Response `200`

Successful response

- ChooseAPushNotificationContentTemplateResponse
  - `name` string

## Changes

- **2025-07-27** `7a85bad03e90`: 1 breaking, 1 warning, 2 info
  - added the new required request property `name`
  - deleted the `header` request parameter `Api-Token`
  - api operation id `choosePushNotificationContentTemplate` removed and replaced with `chooseAPushNotificationContentTemplate`
  - added the new optional `header` request parameter `api-token`
- **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/push/template/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)