---
title: "Updates account notification preferences"
method: POST
path: "/account/profile/notifications"
tags: ["Account"]
---

# Updates account notification preferences

`POST /account/profile/notifications`

Updates user notification preferences for orders, fills, announcements, and transfers. All fields are optional - only provided fields will be updated.

## Request body

- RequestsUpdateNotificationPreferencesRequest
  - `announcements` boolean
  - `fill_sound` boolean
  - `fills` boolean
  - `orders` boolean
  - `transfers` boolean

## Response `200`

OK

- ResponsesAccountProfileResp
  - `ai_agent_url` string
  - `discord` ResponsesDiscordProfile
    - `id` string
    - `image_url` string
    - `username` string
  - `is_username_private` boolean
  - `last_seen_notification` integer
  - `market_max_slippage` object
  - `marketed_by` string
  - `nfts` ResponsesNft[]
    - `collection_address` string
    - `collection_name` string
    - `id` string
    - `image_url` string
    - `name` string
    - `price` Messagesv1NftPrice
      - `currency` string
      - `decimals` integer
      - `value` string
  - `notifications` ResponsesNotificationPreferencesResp
    - `announcements` boolean
    - `fill_sound` boolean
    - `fills` boolean
    - `orders` boolean
    - `transfers` boolean
  - `referral` ResponsesReferralConfigResp
    - `commission_rate` string — Commission rate for the referer
    - `commission_volume_cap` string — Volume cap for commission
    - `discount_rate` string — Discount rate for the referee
    - `discount_volume_cap` string — Volume cap for discount
    - `minimum_volume` string — Minimum volume required to be eligible for Program
    - `name` string — Referral name
    - `points_bonus_rate` string — Points bonus rate for the referee
    - `points_bonus_volume_cap` string — Volume cap for points bonus
    - `referral_type` string — Referral type
  - `referral_code` string
  - `referred_by` string
  - `size_currency_display` string
  - `tap_share_rate` ResponsesShareRateResp
    - `last_updated_at` integer
    - `share_rate` string
  - `tap_status` string — TAP affiliate status: "NONE", "ACTIVE", or "INACTIVE"
  - `twitter` ResponsesTwitterProfile
    - `id` string
    - `image_url` string
    - `username` string
  - `twitter_following` object
  - `username` string
  - `xp_share_rate` ResponsesShareRateResp
    - `last_updated_at` integer
    - `share_rate` string

## Other responses

- `400` — Validation Error
- `401` — Unauthorized

## Changes

- **2026-09-24** `c8ee50dffebb` — 2 warning
  - added the new `MMP_MIN_FREEZE_NOT_ELAPSED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `MMP_MIN_FREEZE_NOT_ELAPSED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
- **2026-09-22** `250909706663` — 8 warning
  - added the new `MMP_CONFIG_INVALID` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `MMP_CONFIG_INVALID` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `MMP_NOT_CONFIGURED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `MMP_NOT_CONFIGURED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/account/profile/notifications/post.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/revisions/c8ee50dffebb?raw)