---
title: "Update account settings"
method: POST
path: "/v1/account.updateSettings"
tags: ["account"]
---

# Update account settings

`POST /v1/account.updateSettings`

## Headers

- `X-Forwarded-For` string

## Request body

- V1AccountUpdateSettingsRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `countryOverride` string, nullable — The country name or code to override the Steam country with. Empty string clears it, omit to leave unchanged
  - `email` string, nullable — The email the account should use. Empty string clears it, omit to leave unchanged
  - `hidden` boolean, nullable — Whether the account should be hidden in the leaderboards. Omit to leave unchanged
  - `language` string, nullable — The language the account should use. Omit to leave unchanged
  - `nameEffect` 'none' | 'rainbow' | 'glitch' | 'shadow' | 'neon' | 'retro' | 'stamped' | 'shatter' | 'typewriter' | 'vaporwave' | 'sunken', nullable — The name effect. none clears it, omit to leave unchanged
  - `themeColor` string, nullable — The profile theme color as #RRGGBB (no alpha). Empty string clears it, omit to leave unchanged
  - `vanity` string, nullable — The vanity the account should use. Empty string clears it, omit to leave unchanged

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

> 11 revisions in range; 1 not diffed.

- **2026-08-05** `2e8ba266b27f` — 7 info
  - added the new optional request property `nameEffect`
  - added the new optional request property `themeColor`
  - the request property `hidden` became nullable
  - the request property `language` became nullable
  - …3 more
- **2026-08-05** `c11dde6130a7` — 1 info
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/steamsets/apis/steamsets-api/changes/v1/account.updateSettings/post.md)

---

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