---
title: "Upsert Preference"
method: PUT
path: "/notification-preferences/{notification_type}"
tags: ["notification-preferences"]
---

# Upsert Preference

`PUT /notification-preferences/{notification_type}`

## Request

- Base URL: `https://api.trytrata.com`
- URL: `https://api.trytrata.com/notification-preferences/{notification_type}`
- Auth: HTTP bearer

Upsert notification preference for a specific type.

Always saves the user's explicit choice, even if it matches defaults.

## Path parameters

- `notification_type` 'NEW_TRANSCRIPT_IN_TICKER_COVERAGE' | 'MY_TRANSCRIPT_PUBLISHED' | 'NEW_TRANSCRIPT' | 'NEW_COMMENT' | 'NEW_COMMENT_WITH_FOLLOWING' | 'NEW_COMMENT_ON_MY_TRANSCRIPT' | 'NEW_UPVOTE_ON_MY_TRANSCRIPT' | 'NEW_BEAR_ON_MY_TRANSCRIPT' | 'NEW_BULL_ON_MY_TRANSCRIPT' | 'MONTHLY_CALL_SUMMARY' | 'WEEKLY_PRIORITY_COVERAGE' | 'ORG_INVITE' | 'REMOVED_FROM_ORG' | 'CALL_REMINDER' | 'CALL_SCHEDULING_TURN', required

## Request body

- UpsertPreferenceRequest
  - `email_enabled` boolean, required
  - `text_enabled` boolean, required

## Response `200`

Successful Response

- NotificationPreferenceResponse
  - `user_id` string, required
  - `notification_type` 'NEW_TRANSCRIPT_IN_TICKER_COVERAGE' | 'MY_TRANSCRIPT_PUBLISHED' | 'NEW_TRANSCRIPT' | 'NEW_COMMENT' | 'NEW_COMMENT_WITH_FOLLOWING' | 'NEW_COMMENT_ON_MY_TRANSCRIPT' | 'NEW_UPVOTE_ON_MY_TRANSCRIPT' | 'NEW_BEAR_ON_MY_TRANSCRIPT' | 'NEW_BULL_ON_MY_TRANSCRIPT' | 'MONTHLY_CALL_SUMMARY' | 'WEEKLY_PRIORITY_COVERAGE' | 'ORG_INVITE' | 'REMOVED_FROM_ORG' | 'CALL_REMINDER' | 'CALL_SCHEDULING_TURN', required
  - `email_enabled` boolean, required
  - `text_enabled` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-17** `5bfc21609fa6`: 1 warning, 1 info
  - added the new `CALL_SCHEDULING_TURN` enum value to the `notification_type` response property for the response status `200`
  - added the new enum value `CALL_SCHEDULING_TURN` to the `path` request parameter `notification_type`

[Operation history](https://skmtc.dev/trytrata/apis/trytrata-api/changes/notification-preferences/:notification_type/put.md)

---

[API](https://skmtc.dev/trytrata/apis/trytrata-api.md) - [All operations](https://skmtc.dev/trytrata/apis/trytrata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytrata/apis/trytrata-api/revisions/a6a3d5ff6ed0?raw)