Mixpanel Track checks event fields and the 2,000-event limit.
Mixpanel documents at most 2,000 events per Track request. The pack checks this cardinality on supported event arrays, including arrays recovered from a recognized data field. The project token is properties.token inside each event. Cardinality is independent of whether each record satisfies its field checks.
event and properties.token are required. distinct_id and $insert_id are recommended, time is an integer timestamp, and query ip, verbose and img are 0 or 1. properties.ip is an address rather than a digest. Import, Engage and Groups have separate packs and endpoint contracts. Offline checks cannot establish live project-token validity or ingestion success.
The selected built-in Track pack can inspect the official JavaScript SDK's text/plain POST body on exact /track or /track/ endpoints. One strictly decoded data= member exposes supported raw JSON or Base64 to existing event rules. The original media type, body and byte counts remain captured evidence; other selected or custom plugins keep their ordinary representation.
Extra or repeated form members, competing query data, unavailable capture context and the verified paired-CESU-8 Base64 producer boundary retain explicit information findings. Local byte, structure, finding-text and work bounds can defer body checks without asserting destination rejection. Arbitrary plain text, literal JSON text and existing compression contracts retain their prior behavior.
A Track request can contain at most 2,000 events.
The maximum applies to a supported event array, including a decoded data field. A 2,001st record produces a root constraint error while existing event checks continue. Split the request while preserving each event and its identity. Import, Engage and Groups retain their separate contracts.
token is properties.token
Not the HTTP header, not a root field. Mixpanel documents it inside the event properties object.
An ambiguous SDK body keeps its payload checks unvalidated.
The built-in interpretation applies only to a selected matching owner, POST, an exact Track route and one observed supported text/plain media type. Conflicting query and body data or unsupported form structure receive information findings. No custom replacement or unrelated endpoint inherits that capability.
What this pack matches
Rules
Codes are stable. A finding in CI, MCP, or the playground lands on the same id.
| Field | Required | What it checks | Rule ids | Source |
|---|---|---|---|---|
ip |
optional | Mixpanel documents `ip=1` so the request address is used to compute a `distinct_id` when none is sent. | vendor.mixpanel.param.ip.emptyvendor.mixpanel.param.ip.invalid |
docs |
verbose |
optional | Mixpanel documents `verbose=1` so the 200 body says whether the track call was accepted. | vendor.mixpanel.param.verbose.emptyvendor.mixpanel.param.verbose.invalid |
docs |
img |
optional | Mixpanel documents `img=1` so the response is a 1x1 transparent pixel. | vendor.mixpanel.param.img.emptyvendor.mixpanel.param.img.invalid |
docs |
data |
optional | The official browser SDK encodes the event or profile update in data for the legacy base64 transport. | vendor.mixpanel.param.data.empty |
docs |
https_required |
required | Mixpanel explicitly rejects non-HTTPS API requests. | vendor.mixpanel.https_required |
docs |
root |
optional | Track accepts a nonempty batch of at most 2000 event records. The limit counts records, including supported decoded JSON and form captures. Native JSON type: array. Minimum array items: 1. Maximum array items: 2000. Fix: Split the request into batches of at most 2000 records while retaining each record and its identity. | vendor.mixpanel.body.root.invalid |
docs |
event |
required | Mixpanel documents the event name as required. Body scope: []. Native JSON type: string. Fix: Name the event, such as `Signed Up`. | vendor.mixpanel.body.event.missingvendor.mixpanel.body.event.emptyvendor.mixpanel.body.event.invalid |
docs |
properties |
required | Mixpanel documents the properties object as required, since the project token rides inside it. Body scope: []. Native JSON type: object. Maximum object properties: 254. Fix: Add a `properties` object carrying at least `token`. | vendor.mixpanel.body.properties.missingvendor.mixpanel.body.properties.invalid |
docs |
unknown_fields… |
forbidden | The track schema rejects fields other than event and properties on each event object. Property keys inside properties stay open. Body scope: []. Fix: Move extra values into properties, or drop them. | vendor.mixpanel.body.unknown_fields.forbidden |
docs |
properties.token |
required | It is the project token the event is attributed to. Body scope: []. Native JSON type: string. Fix: Send the project token from your Mixpanel project settings. | vendor.mixpanel.body.properties.token.missingvendor.mixpanel.body.properties.token.emptyvendor.mixpanel.body.properties.token.invalid |
docs |
properties.distinct_id |
recommended | It identifies the user who performed the event. Mixpanel documents it as the unique user identifier; without it the event is not tied to a person. Body scope: []. Native JSON type: string or integer. Fix: Send the same `distinct_id` you use elsewhere for this user. | vendor.mixpanel.body.properties.distinct_id.missingvendor.mixpanel.body.properties.distinct_id.emptyvendor.mixpanel.body.properties.distinct_id.invalid |
docs |
properties.time |
optional | Mixpanel documents `time` as a Unix timestamp in seconds or milliseconds. A non-numeric value is not that format. Body scope: []. Native JSON type: integer. Fix: Send seconds or milliseconds since epoch, as an integer. | vendor.mixpanel.body.properties.time.emptyvendor.mixpanel.body.properties.time.invalid |
docs |
properties.$insert_id |
recommended | Mixpanel uses it to drop duplicates, so a retried request is not counted twice. `/import` requires it in vendor/mixpanel-import. Body scope: []. Native JSON type: string. Fix: Send a stable id per event. | vendor.mixpanel.body.properties.$insert_id.missingvendor.mixpanel.body.properties.$insert_id.emptyvendor.mixpanel.body.properties.$insert_id.invalid |
docs |
properties.ip |
optional | Mixpanel uses `properties.ip` for GeoIP. This is different from the query `ip` flag. Send an address, not a digest. Body scope: []. Native JSON type: string. | vendor.mixpanel.body.properties.ip.emptyvendor.mixpanel.body.properties.ip.invalid |
docs |
properties.$current_url |
optional | It is the URL of the page on which the event was tracked. Mixpanel documents `$current_url` on the JavaScript SDK default-property table. Body scope: []. Native JSON type: string. Fix: Send an absolute URL in `properties.$current_url`, including the scheme. | vendor.mixpanel.body.properties.$current_url.emptyvendor.mixpanel.body.properties.$current_url.invalid |
docs |
properties.$referrer |
optional | It is the referring URL, including your own domain. Mixpanel documents `$referrer` on the JavaScript SDK default-property table. `$direct` belongs on `$initial_referrer`, not here. Body scope: []. Native JSON type: string. Fix: Send an absolute referring URL, or omit the field when `document.referrer` is empty. | vendor.mixpanel.body.properties.$referrer.emptyvendor.mixpanel.body.properties.$referrer.invalid |
docs |
properties.mp_lib |
optional | It names the Mixpanel library that sent the event, such as `web`, `android`, `swift`, `react-native`, or `flutter`. Mixpanel documents `mp_lib` on the SDK default-property table. Body scope: []. Native JSON type: string. Fix: Send `properties.mp_lib`, or drop the empty pair. | vendor.mixpanel.body.properties.mp_lib.emptyvendor.mixpanel.body.properties.mp_lib.invalid |
docs |
properties.$lib_version |
optional | It is the Mixpanel library version. Mixpanel documents `$lib_version` on the SDK default-property table. Body scope: []. Native JSON type: string. Fix: Send `properties.$lib_version`, or drop the empty pair. | vendor.mixpanel.body.properties.$lib_version.emptyvendor.mixpanel.body.properties.$lib_version.invalid |
docs |
properties.$device_id |
optional | It is the device-local Mixpanel ID. Mixpanel documents `$device_id` as regenerated by `reset()`. Body scope: []. Native JSON type: string. Fix: Send `properties.$device_id`, or drop the empty pair. | vendor.mixpanel.body.properties.$device_id.emptyvendor.mixpanel.body.properties.$device_id.invalid |
docs |
properties.$user_id |
optional | It is the identified user ID. Mixpanel documents `$user_id` as set by `identify()`. Body scope: []. Native JSON type: string. Fix: Send `properties.$user_id` after identify, or drop the empty pair. | vendor.mixpanel.body.properties.$user_id.emptyvendor.mixpanel.body.properties.$user_id.invalid |
docs |
properties.$screen_height |
optional | It is the device screen height in pixels, or points on iOS. Mixpanel documents `$screen_height` on the SDK default-property table. Body scope: []. Native JSON type: integer. Fix: Send `properties.$screen_height` as an integer pixel or point count. | vendor.mixpanel.body.properties.$screen_height.emptyvendor.mixpanel.body.properties.$screen_height.invalid |
docs |
properties.$screen_width |
optional | It is the device screen width in pixels, or points on iOS. Mixpanel documents `$screen_width` on the SDK default-property table. Body scope: []. Native JSON type: integer. Fix: Send `properties.$screen_width` as an integer pixel or point count. | vendor.mixpanel.body.properties.$screen_width.emptyvendor.mixpanel.body.properties.$screen_width.invalid |
docs |
root |
optional | The vendor documents `` in the request contract. Body scope: []. Native JSON type: object. | vendor.mixpanel.body.root.invalid |
docs |
body.hashed_plaintext_field |
required | `properties.ip` looks like a SHA-256 digest, but Mixpanel documents it as an IP address. Body scope: []. Fix: Send the raw IP address. | vendor.mixpanel.body.hashed_plaintext_field |
docs |
root |
optional | The official SDK data transport accepts a single event object or a nonempty batch of at most 2000 event records. The count limit applies to the decoded array. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: object or array. Minimum array items: 1. Maximum array items: 2000. Fix: Split the request into batches of at most 2000 records while retaining each record and its identity. | vendor.mixpanel.body.root.invalid |
docs |
event |
required | Mixpanel documents the event name as required. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Name the event, such as `Signed Up`. | vendor.mixpanel.body.event.missingvendor.mixpanel.body.event.emptyvendor.mixpanel.body.event.invalid |
docs |
properties |
required | Mixpanel documents the properties object as required, since the project token rides inside it. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: object. Maximum object properties: 254. Fix: Add a `properties` object carrying at least `token`. | vendor.mixpanel.body.properties.missingvendor.mixpanel.body.properties.invalid |
docs |
unknown_fields… |
forbidden | The track schema rejects fields other than event and properties on each event object. Property keys inside properties stay open. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Fix: Move extra values into properties, or drop them. | vendor.mixpanel.body.unknown_fields.forbidden |
docs |
properties.token |
required | It is the project token the event is attributed to. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send the project token from your Mixpanel project settings. | vendor.mixpanel.body.properties.token.missingvendor.mixpanel.body.properties.token.emptyvendor.mixpanel.body.properties.token.invalid |
docs |
properties.distinct_id |
recommended | It identifies the user who performed the event. Mixpanel documents it as the unique user identifier; without it the event is not tied to a person. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string or integer. Fix: Send the same `distinct_id` you use elsewhere for this user. | vendor.mixpanel.body.properties.distinct_id.missingvendor.mixpanel.body.properties.distinct_id.emptyvendor.mixpanel.body.properties.distinct_id.invalid |
docs |
properties.time |
optional | Mixpanel documents `time` as a Unix timestamp in seconds or milliseconds. A non-numeric value is not that format. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: integer. Fix: Send seconds or milliseconds since epoch, as an integer. | vendor.mixpanel.body.properties.time.emptyvendor.mixpanel.body.properties.time.invalid |
docs |
properties.$insert_id |
recommended | Mixpanel uses it to drop duplicates, so a retried request is not counted twice. `/import` requires it in vendor/mixpanel-import. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send a stable id per event. | vendor.mixpanel.body.properties.$insert_id.missingvendor.mixpanel.body.properties.$insert_id.emptyvendor.mixpanel.body.properties.$insert_id.invalid |
docs |
properties.ip |
optional | Mixpanel uses `properties.ip` for GeoIP. This is different from the query `ip` flag. Send an address, not a digest. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. | vendor.mixpanel.body.properties.ip.emptyvendor.mixpanel.body.properties.ip.invalid |
docs |
properties.$current_url |
optional | It is the URL of the page on which the event was tracked. Mixpanel documents `$current_url` on the JavaScript SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send an absolute URL in `properties.$current_url`, including the scheme. | vendor.mixpanel.body.properties.$current_url.emptyvendor.mixpanel.body.properties.$current_url.invalid |
docs |
properties.$referrer |
optional | It is the referring URL, including your own domain. Mixpanel documents `$referrer` on the JavaScript SDK default-property table. `$direct` belongs on `$initial_referrer`, not here. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send an absolute referring URL, or omit the field when `document.referrer` is empty. | vendor.mixpanel.body.properties.$referrer.emptyvendor.mixpanel.body.properties.$referrer.invalid |
docs |
properties.mp_lib |
optional | It names the Mixpanel library that sent the event, such as `web`, `android`, `swift`, `react-native`, or `flutter`. Mixpanel documents `mp_lib` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send `properties.mp_lib`, or drop the empty pair. | vendor.mixpanel.body.properties.mp_lib.emptyvendor.mixpanel.body.properties.mp_lib.invalid |
docs |
properties.$lib_version |
optional | It is the Mixpanel library version. Mixpanel documents `$lib_version` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send `properties.$lib_version`, or drop the empty pair. | vendor.mixpanel.body.properties.$lib_version.emptyvendor.mixpanel.body.properties.$lib_version.invalid |
docs |
properties.$device_id |
optional | It is the device-local Mixpanel ID. Mixpanel documents `$device_id` as regenerated by `reset()`. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send `properties.$device_id`, or drop the empty pair. | vendor.mixpanel.body.properties.$device_id.emptyvendor.mixpanel.body.properties.$device_id.invalid |
docs |
properties.$user_id |
optional | It is the identified user ID. Mixpanel documents `$user_id` as set by `identify()`. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: string. Fix: Send `properties.$user_id` after identify, or drop the empty pair. | vendor.mixpanel.body.properties.$user_id.emptyvendor.mixpanel.body.properties.$user_id.invalid |
docs |
properties.$screen_height |
optional | It is the device screen height in pixels, or points on iOS. Mixpanel documents `$screen_height` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: integer. Fix: Send `properties.$screen_height` as an integer pixel or point count. | vendor.mixpanel.body.properties.$screen_height.emptyvendor.mixpanel.body.properties.$screen_height.invalid |
docs |
properties.$screen_width |
optional | It is the device screen width in pixels, or points on iOS. Mixpanel documents `$screen_width` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: integer. Fix: Send `properties.$screen_width` as an integer pixel or point count. | vendor.mixpanel.body.properties.$screen_width.emptyvendor.mixpanel.body.properties.$screen_width.invalid |
docs |
root |
optional | The vendor documents `` in the request contract. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Native JSON type: object. | vendor.mixpanel.body.root.invalid |
docs |
body.hashed_plaintext_field |
required | `properties.ip` looks like a SHA-256 digest, but Mixpanel documents it as an IP address. Body scope: ["[]",""]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Fix: Send the raw IP address. | vendor.mixpanel.body.hashed_plaintext_field |
docs |
root |
optional | Body scope: [].properties.**. Presence diagnostic severity: error. Value diagnostic severity: error. Native JSON type: string or number or boolean or object or array or null. Maximum array items: 254. Maximum object properties: 254. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: [].properties.**. Presence diagnostic severity: error. Value diagnostic severity: warning. Native JSON type: string or number or boolean or object or array or null. Maximum decoded UTF-8 bytes: 255. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: [].properties.*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Presence diagnostic severity: error. Value diagnostic severity: error. Native JSON type: string or number or boolean or object or array or null. Maximum container depth: 3. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: [].properties.**[]. Applies when {"kind":"json_type","param":"","json_type":"object"}. Presence diagnostic severity: error. Value diagnostic severity: warning. Native JSON type: string or number or boolean or object or array or null. Maximum container depth: 1. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: ["[].properties.**","properties.**"]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Presence diagnostic severity: error. Value diagnostic severity: error. Native JSON type: string or number or boolean or object or array or null. Maximum array items: 254. Maximum object properties: 254. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: ["[].properties.**","properties.**"]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Presence diagnostic severity: error. Value diagnostic severity: warning. Native JSON type: string or number or boolean or object or array or null. Maximum decoded UTF-8 bytes: 255. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: ["[].properties.*","properties.*"]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Applies when {"kind":"json_type","param":"","json_type":"object"}. Presence diagnostic severity: error. Value diagnostic severity: error. Native JSON type: string or number or boolean or object or array or null. Maximum container depth: 3. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: ["[].properties.**[]","properties.**[]"]. Decoded body source: data. Encoding: base64_json. Applies when {"kind":"not","condition":{"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}}. Applies when {"kind":"json_type","param":"","json_type":"object"}. Presence diagnostic severity: error. Value diagnostic severity: warning. Native JSON type: string or number or boolean or object or array or null. Maximum container depth: 1. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | The official SDK data transport accepts a single event object or a nonempty batch of at most 2000 event records. The count limit applies to the decoded array. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: object or array. Minimum array items: 1. Maximum array items: 2000. Fix: Split the request into batches of at most 2000 records while retaining each record and its identity. | vendor.mixpanel.body.root.invalid |
docs |
event |
required | Mixpanel documents the event name as required. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Name the event, such as `Signed Up`. | vendor.mixpanel.body.event.missingvendor.mixpanel.body.event.emptyvendor.mixpanel.body.event.invalid |
docs |
properties |
required | Mixpanel documents the properties object as required, since the project token rides inside it. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: object. Maximum object properties: 254. Fix: Add a `properties` object carrying at least `token`. | vendor.mixpanel.body.properties.missingvendor.mixpanel.body.properties.invalid |
docs |
unknown_fields… |
forbidden | The track schema rejects fields other than event and properties on each event object. Property keys inside properties stay open. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Fix: Move extra values into properties, or drop them. | vendor.mixpanel.body.unknown_fields.forbidden |
docs |
properties.token |
required | It is the project token the event is attributed to. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send the project token from your Mixpanel project settings. | vendor.mixpanel.body.properties.token.missingvendor.mixpanel.body.properties.token.emptyvendor.mixpanel.body.properties.token.invalid |
docs |
properties.distinct_id |
recommended | It identifies the user who performed the event. Mixpanel documents it as the unique user identifier; without it the event is not tied to a person. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string or integer. Fix: Send the same `distinct_id` you use elsewhere for this user. | vendor.mixpanel.body.properties.distinct_id.missingvendor.mixpanel.body.properties.distinct_id.emptyvendor.mixpanel.body.properties.distinct_id.invalid |
docs |
properties.time |
optional | Mixpanel documents `time` as a Unix timestamp in seconds or milliseconds. A non-numeric value is not that format. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: integer. Fix: Send seconds or milliseconds since epoch, as an integer. | vendor.mixpanel.body.properties.time.emptyvendor.mixpanel.body.properties.time.invalid |
docs |
properties.$insert_id |
recommended | Mixpanel uses it to drop duplicates, so a retried request is not counted twice. `/import` requires it in vendor/mixpanel-import. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send a stable id per event. | vendor.mixpanel.body.properties.$insert_id.missingvendor.mixpanel.body.properties.$insert_id.emptyvendor.mixpanel.body.properties.$insert_id.invalid |
docs |
properties.ip |
optional | Mixpanel uses `properties.ip` for GeoIP. This is different from the query `ip` flag. Send an address, not a digest. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. | vendor.mixpanel.body.properties.ip.emptyvendor.mixpanel.body.properties.ip.invalid |
docs |
properties.$current_url |
optional | It is the URL of the page on which the event was tracked. Mixpanel documents `$current_url` on the JavaScript SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send an absolute URL in `properties.$current_url`, including the scheme. | vendor.mixpanel.body.properties.$current_url.emptyvendor.mixpanel.body.properties.$current_url.invalid |
docs |
properties.$referrer |
optional | It is the referring URL, including your own domain. Mixpanel documents `$referrer` on the JavaScript SDK default-property table. `$direct` belongs on `$initial_referrer`, not here. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send an absolute referring URL, or omit the field when `document.referrer` is empty. | vendor.mixpanel.body.properties.$referrer.emptyvendor.mixpanel.body.properties.$referrer.invalid |
docs |
properties.mp_lib |
optional | It names the Mixpanel library that sent the event, such as `web`, `android`, `swift`, `react-native`, or `flutter`. Mixpanel documents `mp_lib` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send `properties.mp_lib`, or drop the empty pair. | vendor.mixpanel.body.properties.mp_lib.emptyvendor.mixpanel.body.properties.mp_lib.invalid |
docs |
properties.$lib_version |
optional | It is the Mixpanel library version. Mixpanel documents `$lib_version` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send `properties.$lib_version`, or drop the empty pair. | vendor.mixpanel.body.properties.$lib_version.emptyvendor.mixpanel.body.properties.$lib_version.invalid |
docs |
properties.$device_id |
optional | It is the device-local Mixpanel ID. Mixpanel documents `$device_id` as regenerated by `reset()`. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send `properties.$device_id`, or drop the empty pair. | vendor.mixpanel.body.properties.$device_id.emptyvendor.mixpanel.body.properties.$device_id.invalid |
docs |
properties.$user_id |
optional | It is the identified user ID. Mixpanel documents `$user_id` as set by `identify()`. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: string. Fix: Send `properties.$user_id` after identify, or drop the empty pair. | vendor.mixpanel.body.properties.$user_id.emptyvendor.mixpanel.body.properties.$user_id.invalid |
docs |
properties.$screen_height |
optional | It is the device screen height in pixels, or points on iOS. Mixpanel documents `$screen_height` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: integer. Fix: Send `properties.$screen_height` as an integer pixel or point count. | vendor.mixpanel.body.properties.$screen_height.emptyvendor.mixpanel.body.properties.$screen_height.invalid |
docs |
properties.$screen_width |
optional | It is the device screen width in pixels, or points on iOS. Mixpanel documents `$screen_width` on the SDK default-property table. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: integer. Fix: Send `properties.$screen_width` as an integer pixel or point count. | vendor.mixpanel.body.properties.$screen_width.emptyvendor.mixpanel.body.properties.$screen_width.invalid |
docs |
root |
optional | The vendor documents `` in the request contract. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Native JSON type: object. | vendor.mixpanel.body.root.invalid |
docs |
body.hashed_plaintext_field |
required | `properties.ip` looks like a SHA-256 digest, but Mixpanel documents it as an IP address. Body scope: ["[]",""]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Fix: Send the raw IP address. | vendor.mixpanel.body.hashed_plaintext_field |
docs |
root |
optional | Body scope: ["[].properties.**","properties.**"]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Presence diagnostic severity: error. Value diagnostic severity: error. Native JSON type: string or number or boolean or object or array or null. Maximum array items: 254. Maximum object properties: 254. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: ["[].properties.**","properties.**"]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Presence diagnostic severity: error. Value diagnostic severity: warning. Native JSON type: string or number or boolean or object or array or null. Maximum decoded UTF-8 bytes: 255. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: ["[].properties.*","properties.*"]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Applies when {"kind":"json_type","param":"","json_type":"object"}. Presence diagnostic severity: error. Value diagnostic severity: error. Native JSON type: string or number or boolean or object or array or null. Maximum container depth: 3. | vendor.mixpanel.body.root.invalid |
docs |
root |
optional | Body scope: ["[].properties.**[]","properties.**[]"]. Decoded body source: data. Encoding: json. Applies when {"kind":"value_pattern","param":"data","pattern":"^\\s*[\\[{]"}. Applies when {"kind":"json_type","param":"","json_type":"object"}. Presence diagnostic severity: error. Value diagnostic severity: warning. Native JSON type: string or number or boolean or object or array or null. Maximum container depth: 1. | vendor.mixpanel.body.root.invalid |
docs |
method |
required | The official SDK uses POST or GET fallback for this operation. Complete HTTP capture contract. Native JSON type: string. | vendor.mixpanel.http.method.missingvendor.mixpanel.http.method.emptyvendor.mixpanel.http.method.invalid |
docs |
content_type |
optional | Published native JSON, XHR form and sendBeacon text representations are retained. Complete HTTP capture contract. Applies when {"kind":"value_in","param":"method","values":["POST"]}. Presence diagnostic severity: warning. Value diagnostic severity: warning. Native JSON type: string. | vendor.mixpanel.http.content_type.emptyvendor.mixpanel.http.content_type.invalid |
docs |
headers.content-encoding |
optional | HTTP content encoding, when supplied. This endpoint documents its own gzip policy. Complete HTTP capture contract. Native JSON type: string. | vendor.mixpanel.http.headers.content-encoding.emptyvendor.mixpanel.http.headers.content-encoding.invalid |
docs |
Validate a payload
Use an explicit request capture to retain the SDK body, method and observed headers.
pixellint validate request @request.json --rulepack vendor/mixpanel
pixellint validate json @payload.json --rulepack vendor/mixpanel
Try this failing payload in the playground. Mixpanel track with a hashed properties.ip.
[{"event":"Signed Up","properties":{"token":"mp-token-abc","distinct_id":"user-10024","$insert_id":"evt-9931","time":1770000000,"ip":"a85e9ca18f34935ab9b0381b25bfad2455444112b0149270fd88e3da172fe196"}}]
cargo install pixellint
·
npm install pixellint