Update Multiple Profiles

post

https://{region}.mixpanel.com/engage#profile-batch-update

Send a batch of profile updates. Instead of sending a single JSON object as the data query parameter, send a JSON list of objects as the data parameter of an application/json POST or GET request body.

Refer to the respective user profile update commands ($set, $set_once, $add, $union, $append, $remove, $unset, and $delete) on syntax for their parameters.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

integer

0 to 1

Defaults to 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.

strict

integer

0 to 1

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

0 to 1

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.

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 Params

A JSON list of update objects, each with a $token, $distinct_id, and an operation.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

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.

401Unauthorized

403Forbidden