---
title: "Increment Numerical Property"
method: POST
path: "/engage#profile-numerical-add"
tags: ["User Profiles"]
---

# Increment Numerical Property

`POST /engage#profile-numerical-add`

Takes a JSON object containing keys and numerical values. \$add will increment the value of a user profile property. When processed, the property values are added to the existing values of the properties on the profile. If the property is not present on the profile, the value will be added to 0. It is possible to decrement by calling "\$add" with negative values. This is useful for maintaining the values of properties like "Number of Logins" or "Files Uploaded".

## Query parameters

- `ip` integer — If present and equal to 0, Mixpanel will not perform geolocation parsing using the IP address of the request. We recommend setting the ip to "0" when making requests from the server-side to prevent the unintentional effect of overwriting your profile's geolocation with your server location. Defaults to 1 which would use the IP address of the request to update profile geolocation.
- `strict` integer — If present and equal to 1, Mixpanel will validate the provided records and return a JSON object with per-record error messages for records that fail validation.
- `verbose` integer
- `callback` string

## Request body

- object[]
  - `$token` string, required
  - `$distinct_id` string, required
  - `$add` object, required

## Response `200`

* `1` - One or more objects provided are valid. This does not signify a valid project token or secret.
* `0` - No data objects in the body are valid.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/mixpanel/apis/query-api.md) · [All operations](https://skmtc.net/mixpanel/apis/query-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpanel/query-api/revisions/f442da95252a/schema)