---
title: "Save user preferences."
method: POST
path: "/user/preferences"
tags: ["User"]
---

# Save user preferences.

`POST /user/preferences`

## Response `200`

Request was successful

- User — Account Operations
  - `id` integer
  - `firstname` string
  - `lastname` string
  - `username` string, required
  - `accountName` string
  - `isUser` boolean, required
  - `email` string
  - `dateOfBirth` string
  - `phone` string
  - `created` string, date-time
  - `lastUpdated` string, date-time
  - `preferences` UserPreferences
    - `alertOnLiquidations` boolean
    - `animationsEnabled` boolean
    - `announcementsLastSeen` string, date-time
    - `chatChannelID` number, double
    - `colorTheme` string
    - `currency` string
    - `debug` boolean
    - `disableEmails` string[]
    - `disablePush` string[]
    - `displayCorpEnrollUpsell` boolean
    - `equivalentCurrency` string
    - `features` string[]
    - `favourites` string[]
    - `favouritesAssets` string[]
    - `favouritesOrdered` string[]
    - `favouriteBots` string[]
    - `hasSetTradingCurrencies` boolean
    - `hideConfirmDialogs` string[]
    - `hideConnectionModal` boolean
    - `hideFromLeaderboard` boolean
    - `hideNameFromLeaderboard` boolean
    - `hidePnlInGuilds` boolean
    - `hideRoiInGuilds` boolean
    - `hideNotifications` string[]
    - `hidePhoneConfirm` boolean
    - `isSensitiveInfoVisible` boolean
    - `isWalletZeroBalanceHidden` boolean
    - `locale` string
    - `localeSetTime` number, double
    - `marginPnlRow` string
    - `marginPnlRowKind` string
    - `mobileLocale` string
    - `msgsSeen` string[]
    - `notifications` object
    - `optionsBeta` boolean
    - `orderBookBinning` object
    - `orderBookType` string
    - `orderClearImmediate` boolean
    - `orderControlsPlusMinus` boolean
    - `platformLayout` string
    - `selectedFiatCurrency` string
    - `showChartBottomToolbar` boolean
    - `showLocaleNumbers` boolean
    - `sounds` string[]
    - `spacingPreference` string
    - `strictIPCheck` boolean
    - `strictTimeout` boolean
    - `tickerGroup` string
    - `tickerPinned` boolean
    - `tradeLayout` string
    - `userColor` string
  - `TFAEnabled` string
  - `affiliateID` string
  - `country` string
  - `geoipCountry` string
  - `geoipRegion` string
  - `firstTradeTimestamp` string, date-time
  - `firstDepositTimestamp` string, date-time
  - `typ` string

## Other responses

- `400` — Parameter Error
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not Found

## Changes

- **2019-12-18** `fd2de3a82a03` — 4 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
- **2018-05-30** `0c1c991454e3` — 4 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`

[Change history](https://skmtc.dev/bitmex/apis/bitmex-api/changes/user/preferences/post.md)

---

[API](https://skmtc.dev/bitmex/apis/bitmex-api.md) · [All operations](https://skmtc.dev/bitmex/apis/bitmex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitmex/bitmex-api/revisions/04c6a16ffd27/schema)