---
title: "Increment/Decrement Numeric Property"
method: POST
path: "/{WSID}/{version}/profiles/properties/numerical-add"
tags: ["User Properties"]
---

# Increment/Decrement Numeric Property

`POST /{WSID}/{version}/profiles/properties/numerical-add`

This API enables you to increment/decrement values of numeric 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. To decrement property values, you can pass a negative value.

**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 set to `Number`. For example, if you `$add` a new property called `ltv=1200`, it will create the `ltv` property with `Number` type and value `1200`. Do not enclose the value in double quotes as they must be of numeric type.

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

- IncrementUserProperty
  - `$add` IncrementUserPropertyFields, required — Enter the property name as JSON key and the numeric value to increment/decrement 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` — $add object is empty
- `401` — API Key or Workspace ID is invalid. User is unauthorised.

---

[API](https://skmtc.net/fynoio/apis/fyno-rest-api.md) · [All operations](https://skmtc.net/fynoio/apis/fyno-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fynoio/fyno-rest-api/versions/021088e9cb30/schema)