pixellint

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.

Rule: vendor.mixpanel.body.root.invalid

token is properties.token

Not the HTTP header, not a root field. Mixpanel documents it inside the event properties object.

Rule: vendor.mixpanel.body.properties.token.empty

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.

Rule: core.request.sdk_body_unvalidated

What this pack matches

Hosts
mixpanel.com
Paths
…/track…
Vendor docs
docs.mixpanel.com/reference/track-event

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.empty
vendor.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.empty
vendor.mixpanel.param.verbose.invalid
docs
img optional Mixpanel documents `img=1` so the response is a 1x1 transparent pixel. vendor.mixpanel.param.img.empty
vendor.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.missing
vendor.mixpanel.body.event.empty
vendor.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.missing
vendor.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.missing
vendor.mixpanel.body.properties.token.empty
vendor.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.missing
vendor.mixpanel.body.properties.distinct_id.empty
vendor.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.empty
vendor.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.missing
vendor.mixpanel.body.properties.$insert_id.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.mixpanel.body.event.empty
vendor.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.missing
vendor.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.missing
vendor.mixpanel.body.properties.token.empty
vendor.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.missing
vendor.mixpanel.body.properties.distinct_id.empty
vendor.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.empty
vendor.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.missing
vendor.mixpanel.body.properties.$insert_id.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.mixpanel.body.event.empty
vendor.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.missing
vendor.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.missing
vendor.mixpanel.body.properties.token.empty
vendor.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.missing
vendor.mixpanel.body.properties.distinct_id.empty
vendor.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.empty
vendor.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.missing
vendor.mixpanel.body.properties.$insert_id.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.mixpanel.http.method.empty
vendor.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.empty
vendor.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.empty
vendor.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