---
title: "Update User Property"
method: POST
path: "/{WSID}/{version}/profiles/properties/set"
tags: ["User Properties"]
---

# Update User Property

`POST /{WSID}/{version}/profiles/properties/set`

This API enables you to update user properties of your users listed in your [User Profiles](../../user-profiles-overview). If the user with distinct ID doesn't exist, it creates a new user with the provided distinct ID and updates values for all the provided properties.<br/><br/>**Note:** If a [property was not created earlier](../../adding-new-user-property#how-to-add-a-new-user-property-from-user-profile-page), it will create a new property and the data type of the property will be determined based on the data type of the value. For example, if you `$set` a new property called `premium_user=true`, it will create the `premium_user` property with `Boolean` type and value `true`.<br/><br/>These user properties can be used to filter your users for creating [user cohorts](../../creating-cohorts) and [campaigns](../../campaign_creation#creating-a-campaign-using-cohort).

## Path parameters

- `WSID` string, required
- `version` 'live' | 'test', required

## Request body

- SetUserProperty
  - `$set` SetUserPropertyFields, required — Enter the property name as JSON key and the value to set as JSON value
  - `distinct_id` string, required — Enter the distinct ID that you use to identify the recipient.

## Response `202`

Request has been accepted and will be processed asynchronously.

- object
  - `request_id` string, required

## Other responses

- `400` — $set object is empty
- `401` — API Key or Workspace ID is invalid. User is unauthorised.

## Changes

- **2025-02-12** `f9c2e33f3247` — 3 warning
  - removed the request property `$set/property_1`
  - removed the request property `$set/property_2`
  - removed the request property `$set/property_n`
- **2025-02-12** `4a67858d11ce` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fynoio/apis/fyno-rest-api/changes/:WSID/:version/profiles/properties/set/post.md)

---

[API](https://skmtc.dev/fynoio/apis/fyno-rest-api.md) · [All operations](https://skmtc.dev/fynoio/apis/fyno-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fynoio/apis/fyno-rest-api/revisions/f9c2e33f3247?raw)