Skip to main content
POST
/
engage#profile-set
Set Property
curl --request POST \
  --url 'https://{region}.mixpanel.com/engage#profile-set' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "$token": "YOUR_PROJECT_TOKEN",
    "$distinct_id": "13793",
    "$set": {}
  }
]
'
1
This API will return a 200 OK even if there are data validation issues. To ensure the request actually succeeded, you need to check the response body.
This API does not support gzip encoding.

Query Parameters

​
ip
integer
default:0

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.

Required range: 0 <= x <= 1
​
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.

Required range: 0 <= x <= 1
​
verbose
integer

If present and equal to 1, Mixpanel will respond with a JSON Object describing the success or failure of the tracking call. The returned object will have two keys: status, with the value 1 on success and 0 on failure, and error, with a string-valued error message if the request wasn't successful. This is useful for debugging during implementation.

Required range: 0 <= x <= 1
​
callback
string

If present, Mixpanel will return a content-type: text/javascript with a body that calls a function by value provided. This is useful for creating local callbacks to a successful track call in JavaScript.

Body

application/json
Minimum array length: 1
​
$token
string
default:YOUR_PROJECT_TOKEN
required
​
$distinct_id
string
default:13793
required
​
$set
object
required

Response

  • 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.

The response is of type enum<integer>.

Available options:
1,
0