Braze tracking checks the combined request budget.
Braze standard /users/track uploads. Combined-array budget advice preserves legacy per-array limits. Bulk, sync and status routes use separate contracts and are not selected.
The combined 75-object recommendation applies to standard tracking. Legacy per-array limits are preserved; bulk, synchronous and status routes have separate contracts.
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 |
|---|---|---|---|---|
attributes |
optional | Each array is limited to 75 objects under the documented standard and legacy profiles. Current standard contracts additionally limit the combined request to 75; legacy contracts can allow 225 across three arrays. Native JSON type: array. Maximum array items: 75. | vendor.braze.body.attributes.invalid |
docs |
events |
optional | Each array is limited to 75 objects under the documented standard and legacy profiles. Current standard contracts additionally limit the combined request to 75; legacy contracts can allow 225 across three arrays. Native JSON type: array. Maximum array items: 75. | vendor.braze.body.events.invalid |
docs |
purchases |
optional | Each array is limited to 75 objects under the documented standard and legacy profiles. Current standard contracts additionally limit the combined request to 75; legacy contracts can allow 225 across three arrays. Native JSON type: array. Maximum array items: 75. | vendor.braze.body.purchases.invalid |
docs |
attributes[] |
optional | Each entry is an object. Native JSON type: object. | vendor.braze.body.attributes[].invalid |
docs |
events[] |
optional | Each entry is an object. Native JSON type: object. | vendor.braze.body.events[].invalid |
docs |
purchases[] |
optional | Each entry is an object. Native JSON type: object. | vendor.braze.body.purchases[].invalid |
docs |
root |
optional | The vendor documents `` in the request contract. Native JSON type: object. | vendor.braze.body.root.invalid |
docs |
body.combined_object_limit |
recommended | This request contains more than 75 objects across attributes, events and purchases. The current standard limit is combined; legacy contracts allow 75 per array. Check the workspace limit or split the batch. This advice does not establish receiver rejection. | vendor.braze.body.combined_object_limit |
docs |
external_id |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: events[]. Native JSON type: string. | vendor.braze.body.external_id.emptyvendor.braze.body.external_id.invalid |
docs |
user_alias |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: events[]. Native JSON type: object. | vendor.braze.body.user_alias.emptyvendor.braze.body.user_alias.invalid |
docs |
braze_id |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: events[]. Native JSON type: string. | vendor.braze.body.braze_id.emptyvendor.braze.body.braze_id.invalid |
docs |
email |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: events[]. Native JSON type: string. | vendor.braze.body.email.emptyvendor.braze.body.email.invalid |
docs |
phone |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: events[]. Native JSON type: string. | vendor.braze.body.phone.emptyvendor.braze.body.phone.invalid |
docs |
app_id |
optional | It is the App Identifier. Braze documents it as optional on events. Body scope: events[]. Native JSON type: string. Fix: Send `app_id` as the App Identifier from Braze, or drop the empty pair. | vendor.braze.body.app_id.emptyvendor.braze.body.app_id.invalid |
docs |
user_alias.alias_name |
optional | It is the alias identifier. Braze documents it as required on a user alias object, at most 236 bytes. Body scope: events[]. Presence diagnostic severity: error. Native JSON type: string. Maximum decoded UTF-8 bytes: 236. Fix: Set `user_alias.alias_name` to a non-empty identifier of at most 236 bytes. | vendor.braze.body.user_alias.alias_name.emptyvendor.braze.body.user_alias.alias_name.invalid |
docs |
user_alias.alias_label |
optional | It is the alias type. Braze documents it as required on a user alias object, at most 236 bytes. Body scope: events[]. Presence diagnostic severity: error. Native JSON type: string. Maximum decoded UTF-8 bytes: 236. Fix: Set `user_alias.alias_label` to a non-empty label of at most 236 bytes. | vendor.braze.body.user_alias.alias_label.emptyvendor.braze.body.user_alias.alias_label.invalid |
docs |
name |
required | Braze documents the event name as required. Body scope: events[]. Native JSON type: string. Fix: Name the custom event. | vendor.braze.body.name.missingvendor.braze.body.name.emptyvendor.braze.body.name.invalid |
docs |
time |
required | Braze documents the event time as an ISO 8601 datetime, such as `2026-07-26T06:00:00+00:00`. Body scope: events[]. Native JSON type: string. Fix: Send an ISO 8601 datetime rather than an epoch number. | vendor.braze.body.time.missingvendor.braze.body.time.emptyvendor.braze.body.time.invalid |
docs |
_update_existing_only |
optional | Braze documents this as a boolean. When true, the call updates an existing profile and does not create one. Body scope: events[]. Native JSON type: boolean. | vendor.braze.body._update_existing_only.emptyvendor.braze.body._update_existing_only.invalid |
docs |
properties.time |
forbidden | Braze reserves `time` as an event field, not as a custom property name. Body scope: events[]. Fix: Rename the property. `time` is reserved. | vendor.braze.body.properties.time.forbidden |
docs |
properties.event_name |
forbidden | Braze reserves `event_name` and cannot use it as a custom property. Body scope: events[]. Fix: Rename the property. `event_name` is reserved. | vendor.braze.body.properties.event_name.forbidden |
docs |
properties |
optional | The vendor documents `properties` in the request contract. Body scope: events[]. Native JSON type: object. | vendor.braze.body.properties.invalid |
docs |
invalid_property_names… |
forbidden | Braze custom property names must be nonempty, at most 255 characters, and cannot start with a dollar sign. Body scope: events[]. | vendor.braze.body.invalid_property_names.forbidden |
docs |
property_values… |
optional | Braze supports numbers, booleans, strings, arrays, and objects as property values. String values are at most 255 characters. Body scope: events[]. Native JSON type: string or number or boolean or array or object. Maximum decoded characters: 255. | vendor.braze.body.property_values.invalid |
docs |
body.event_one_primary_identifier |
required | Braze forbids external_id and user_alias together in one object. Use the alias creation endpoint to attach an alias to a known external ID. Body scope: events[]. Fix: Send one primary identifier. `email` and `phone` may ride alongside it as attributes. | vendor.braze.body.event_one_primary_identifier |
docs |
body.event_needs_an_identifier |
required | The object carries none of `external_id`, `user_alias`, `braze_id`, `email`, or `phone`. Braze documents one of them as required, and cannot attach the data to a user without one. Body scope: events[]. Fix: Add one of the documented identifiers to the object. | vendor.braze.body.event_needs_an_identifier |
docs |
body.event_alias_requires_name_and_label |
required | A `user_alias` object is missing `alias_name` or `alias_label`. Braze documents both as required, each at most 236 bytes. Body scope: events[]. Fix: Set `user_alias.alias_name` and `user_alias.alias_label`. | vendor.braze.body.event_alias_requires_name_and_label |
docs |
external_id |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: purchases[]. Native JSON type: string. | vendor.braze.body.external_id.emptyvendor.braze.body.external_id.invalid |
docs |
user_alias |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: purchases[]. Native JSON type: object. | vendor.braze.body.user_alias.emptyvendor.braze.body.user_alias.invalid |
docs |
braze_id |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: purchases[]. Native JSON type: string. | vendor.braze.body.braze_id.emptyvendor.braze.body.braze_id.invalid |
docs |
email |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: purchases[]. Native JSON type: string. | vendor.braze.body.email.emptyvendor.braze.body.email.invalid |
docs |
phone |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: purchases[]. Native JSON type: string. | vendor.braze.body.phone.emptyvendor.braze.body.phone.invalid |
docs |
app_id |
optional | It is the App Identifier. Braze documents it as optional on purchases. Body scope: purchases[]. Native JSON type: string. Fix: Send `app_id` as the App Identifier from Braze, or drop the empty pair. | vendor.braze.body.app_id.emptyvendor.braze.body.app_id.invalid |
docs |
user_alias.alias_name |
optional | It is the alias identifier. Braze documents it as required on a user alias object, at most 236 bytes. Body scope: purchases[]. Presence diagnostic severity: error. Native JSON type: string. Maximum decoded UTF-8 bytes: 236. Fix: Set `user_alias.alias_name` to a non-empty identifier of at most 236 bytes. | vendor.braze.body.user_alias.alias_name.emptyvendor.braze.body.user_alias.alias_name.invalid |
docs |
user_alias.alias_label |
optional | It is the alias type. Braze documents it as required on a user alias object, at most 236 bytes. Body scope: purchases[]. Presence diagnostic severity: error. Native JSON type: string. Maximum decoded UTF-8 bytes: 236. Fix: Set `user_alias.alias_label` to a non-empty label of at most 236 bytes. | vendor.braze.body.user_alias.alias_label.emptyvendor.braze.body.user_alias.alias_label.invalid |
docs |
product_id |
required | Braze documents the product id as required on a purchase, at most 255 characters. Body scope: purchases[]. Native JSON type: string. Fix: Send a product name or category of at most 255 characters. | vendor.braze.body.product_id.missingvendor.braze.body.product_id.emptyvendor.braze.body.product_id.invalid |
docs |
currency |
required | Braze documents the currency as required on a purchase, as an ISO 4217 code. Body scope: purchases[]. Native JSON type: string. Fix: Use the three-letter code, such as `USD`. | vendor.braze.body.currency.missingvendor.braze.body.currency.emptyvendor.braze.body.currency.invalid |
docs |
price |
required | Braze documents the price as a float in the currency's base unit, such as dollars for USD. Body scope: purchases[]. Native JSON type: number. Fix: Send a number such as `129.99`, with no currency symbol. | vendor.braze.body.price.missingvendor.braze.body.price.emptyvendor.braze.body.price.invalid |
docs |
quantity |
optional | Braze documents quantity as an integer from 1 through 100, defaulting to 1. Body scope: purchases[]. Native JSON type: integer. Minimum numeric value: 1. Maximum numeric value: 100. Fix: Send an integer from 1 to 100. | vendor.braze.body.quantity.emptyvendor.braze.body.quantity.invalid |
docs |
time |
required | Braze documents the purchase time as an ISO 8601 datetime. Body scope: purchases[]. Native JSON type: string. Fix: Send an ISO 8601 datetime rather than an epoch number. | vendor.braze.body.time.missingvendor.braze.body.time.emptyvendor.braze.body.time.invalid |
docs |
_update_existing_only |
optional | Braze documents this as a boolean. When true, the call updates an existing profile and does not create one. Body scope: purchases[]. Native JSON type: boolean. | vendor.braze.body._update_existing_only.emptyvendor.braze.body._update_existing_only.invalid |
docs |
properties.time |
forbidden | Braze reserves `time` and cannot use it as a purchase property name. Body scope: purchases[]. Fix: Rename the property. `time` is reserved. | vendor.braze.body.properties.time.forbidden |
docs |
properties.product_id |
forbidden | Braze reserves `product_id` and cannot use it as a purchase property name. Body scope: purchases[]. Fix: Rename the property. `product_id` is reserved. | vendor.braze.body.properties.product_id.forbidden |
docs |
properties.quantity |
forbidden | Braze reserves `quantity` and cannot use it as a purchase property name. Body scope: purchases[]. Fix: Rename the property. `quantity` is reserved. | vendor.braze.body.properties.quantity.forbidden |
docs |
properties.event_name |
forbidden | Braze reserves `event_name` and cannot use it as a purchase property name. Body scope: purchases[]. Fix: Rename the property. `event_name` is reserved. | vendor.braze.body.properties.event_name.forbidden |
docs |
properties.price |
forbidden | Braze reserves `price` and cannot use it as a purchase property name. Body scope: purchases[]. Fix: Rename the property. `price` is reserved. | vendor.braze.body.properties.price.forbidden |
docs |
properties.currency |
forbidden | Braze reserves `currency` and cannot use it as a purchase property name. Body scope: purchases[]. Fix: Rename the property. `currency` is reserved. | vendor.braze.body.properties.currency.forbidden |
docs |
properties |
optional | The vendor documents `properties` in the request contract. Body scope: purchases[]. Native JSON type: object. | vendor.braze.body.properties.invalid |
docs |
invalid_property_names… |
forbidden | Braze custom property names must be nonempty, at most 255 characters, and cannot start with a dollar sign. Body scope: purchases[]. | vendor.braze.body.invalid_property_names.forbidden |
docs |
property_values… |
optional | Braze supports numbers, booleans, strings, arrays, and objects as property values. String values are at most 255 characters. Body scope: purchases[]. Native JSON type: string or number or boolean or array or object. Maximum decoded characters: 255. | vendor.braze.body.property_values.invalid |
docs |
body.purchase_one_primary_identifier |
required | Braze forbids external_id and user_alias together in one object. Use the alias creation endpoint to attach an alias to a known external ID. Body scope: purchases[]. Fix: Send one primary identifier. `email` and `phone` may ride alongside it as attributes. | vendor.braze.body.purchase_one_primary_identifier |
docs |
body.purchase_needs_an_identifier |
required | The object carries none of `external_id`, `user_alias`, `braze_id`, `email`, or `phone`. Braze documents one of them as required, and cannot attach the data to a user without one. Body scope: purchases[]. Fix: Add one of the documented identifiers to the object. | vendor.braze.body.purchase_needs_an_identifier |
docs |
body.purchase_alias_requires_name_and_label |
required | A `user_alias` object is missing `alias_name` or `alias_label`. Braze documents both as required, each at most 236 bytes. Body scope: purchases[]. Fix: Set `user_alias.alias_name` and `user_alias.alias_label`. | vendor.braze.body.purchase_alias_requires_name_and_label |
docs |
external_id |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.external_id.emptyvendor.braze.body.external_id.invalid |
docs |
user_alias |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: attributes[]. Native JSON type: object. | vendor.braze.body.user_alias.emptyvendor.braze.body.user_alias.invalid |
docs |
braze_id |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.braze_id.emptyvendor.braze.body.braze_id.invalid |
docs |
email |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.email.emptyvendor.braze.body.email.invalid |
docs |
phone |
optional | Braze documents one of external_id, user_alias, braze_id, email, or phone as required on every object. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.phone.emptyvendor.braze.body.phone.invalid |
docs |
user_alias.alias_name |
optional | It is the alias identifier. Braze documents it as required on a user alias object, at most 236 bytes. Body scope: attributes[]. Presence diagnostic severity: error. Native JSON type: string. Maximum decoded UTF-8 bytes: 236. Fix: Set `user_alias.alias_name` to a non-empty identifier of at most 236 bytes. | vendor.braze.body.user_alias.alias_name.emptyvendor.braze.body.user_alias.alias_name.invalid |
docs |
user_alias.alias_label |
optional | It is the alias type. Braze documents it as required on a user alias object, at most 236 bytes. Body scope: attributes[]. Presence diagnostic severity: error. Native JSON type: string. Maximum decoded UTF-8 bytes: 236. Fix: Set `user_alias.alias_label` to a non-empty label of at most 236 bytes. | vendor.braze.body.user_alias.alias_label.emptyvendor.braze.body.user_alias.alias_label.invalid |
docs |
_update_existing_only |
optional | Braze documents this as a boolean. When true, the call updates an existing profile and does not create one. Body scope: attributes[]. Native JSON type: boolean. | vendor.braze.body._update_existing_only.emptyvendor.braze.body._update_existing_only.invalid |
docs |
push_token_import |
optional | Braze documents this as a boolean used when importing anonymous push tokens. Body scope: attributes[]. Native JSON type: boolean. | vendor.braze.body.push_token_import.emptyvendor.braze.body.push_token_import.invalid |
docs |
gender |
optional | Braze documents gender as `M`, `F`, `O`, `N`, `P`, or null. Body scope: attributes[]. Native JSON type: string or null. Fix: Send `M`, `F`, `O`, `N`, or `P`, or omit the field. | vendor.braze.body.gender.emptyvendor.braze.body.gender.invalid |
docs |
email_subscribe |
optional | Braze documents email subscription as `opted_in`, `unsubscribed`, or `subscribed`. Body scope: attributes[]. Native JSON type: string or null. Fix: Send `opted_in`, `unsubscribed`, or `subscribed`. | vendor.braze.body.email_subscribe.emptyvendor.braze.body.email_subscribe.invalid |
docs |
push_subscribe |
optional | Braze documents push subscription as `opted_in`, `unsubscribed`, or `subscribed`. Body scope: attributes[]. Native JSON type: string or null. Fix: Send `opted_in`, `unsubscribed`, or `subscribed`. | vendor.braze.body.push_subscribe.emptyvendor.braze.body.push_subscribe.invalid |
docs |
dob |
optional | Braze documents date of birth as `YYYY-MM-DD`. Body scope: attributes[]. Native JSON type: string or null. Fix: Send the date of birth as `YYYY-MM-DD`, such as `1980-12-21`. | vendor.braze.body.dob.emptyvendor.braze.body.dob.invalid |
docs |
properties |
optional | The vendor documents `properties` in the request contract. Body scope: attributes[]. Native JSON type: object. | vendor.braze.body.properties.invalid |
docs |
first_name |
optional | The vendor documents `first_name` in the request contract. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.first_name.invalid |
docs |
last_name |
optional | The vendor documents `last_name` in the request contract. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.last_name.invalid |
docs |
country |
optional | The vendor documents `country` in the request contract. Body scope: attributes[]. Value diagnostic severity: warning. Native JSON type: string or null. | vendor.braze.body.country.emptyvendor.braze.body.country.invalid |
docs |
home_city |
optional | The vendor documents `home_city` in the request contract. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.home_city.invalid |
docs |
language |
optional | Braze publishes this supported-language list, including three-letter codes and mo. Values outside the current list may be ignored. Null removes the profile value. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.language.invalid |
docs |
time_zone |
optional | The vendor documents `time_zone` in the request contract. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.time_zone.invalid |
docs |
date_of_first_session |
optional | The vendor documents `date_of_first_session` in the request contract. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.date_of_first_session.invalid |
docs |
date_of_last_session |
optional | The vendor documents `date_of_last_session` in the request contract. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.date_of_last_session.invalid |
docs |
marked_email_as_spam_at |
optional | The vendor documents `marked_email_as_spam_at` in the request contract. Body scope: attributes[]. Native JSON type: string or null. | vendor.braze.body.marked_email_as_spam_at.invalid |
docs |
email_open_tracking_disabled |
optional | The vendor documents `email_open_tracking_disabled` in the request contract. Body scope: attributes[]. Native JSON type: boolean or null. | vendor.braze.body.email_open_tracking_disabled.invalid |
docs |
email_click_tracking_disabled |
optional | The vendor documents `email_click_tracking_disabled` in the request contract. Body scope: attributes[]. Native JSON type: boolean or null. | vendor.braze.body.email_click_tracking_disabled.invalid |
docs |
current_location |
optional | The vendor documents `current_location` in the request contract. Body scope: attributes[]. Native JSON type: object or null. | vendor.braze.body.current_location.invalid |
docs |
facebook |
optional | The vendor documents `facebook` in the request contract. Body scope: attributes[]. Native JSON type: object or null. | vendor.braze.body.facebook.invalid |
docs |
twitter |
optional | The vendor documents `twitter` in the request contract. Body scope: attributes[]. Native JSON type: object or null. | vendor.braze.body.twitter.invalid |
docs |
push_tokens |
optional | The vendor documents `push_tokens` in the request contract. Body scope: attributes[]. Native JSON type: array. | vendor.braze.body.push_tokens.invalid |
docs |
subscription_groups |
optional | The vendor documents `subscription_groups` in the request contract. Body scope: attributes[]. Native JSON type: array. | vendor.braze.body.subscription_groups.invalid |
docs |
current_location.latitude |
optional | The vendor documents `current_location.latitude` in the request contract. Body scope: attributes[]. Native JSON type: number. Minimum numeric value: -90. Maximum numeric value: 90. | vendor.braze.body.current_location.latitude.invalid |
docs |
current_location.longitude |
optional | The vendor documents `current_location.longitude` in the request contract. Body scope: attributes[]. Native JSON type: number. Minimum numeric value: -180. Maximum numeric value: 180. | vendor.braze.body.current_location.longitude.invalid |
docs |
push_tokens[] |
optional | The vendor documents `push_tokens[]` in the request contract. Body scope: attributes[]. Native JSON type: object. | vendor.braze.body.push_tokens[].invalid |
docs |
subscription_groups[] |
optional | The vendor documents `subscription_groups[]` in the request contract. Body scope: attributes[]. Native JSON type: object. | vendor.braze.body.subscription_groups[].invalid |
docs |
push_tokens[].app_id |
required | The vendor documents `push_tokens[].app_id` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.push_tokens[].app_id.missingvendor.braze.body.push_tokens[].app_id.invalid |
docs |
push_tokens[].token |
required | The vendor documents `push_tokens[].token` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.push_tokens[].token.missingvendor.braze.body.push_tokens[].token.invalid |
docs |
subscription_groups[].subscription_group_id |
required | The vendor documents `subscription_groups[].subscription_group_id` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.subscription_groups[].subscription_group_id.missingvendor.braze.body.subscription_groups[].subscription_group_id.invalid |
docs |
subscription_groups[].subscription_state |
required | The vendor documents `subscription_groups[].subscription_state` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.subscription_groups[].subscription_state.missingvendor.braze.body.subscription_groups[].subscription_state.emptyvendor.braze.body.subscription_groups[].subscription_state.invalid |
docs |
push_tokens[].device_id |
optional | The vendor documents `push_tokens[].device_id` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.push_tokens[].device_id.invalid |
docs |
facebook.id |
optional | The vendor documents `facebook.id` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.facebook.id.invalid |
docs |
twitter.screen_name |
optional | The vendor documents `twitter.screen_name` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.twitter.screen_name.invalid |
docs |
facebook.likes |
optional | The vendor documents `facebook.likes` in the request contract. Body scope: attributes[]. Native JSON type: array. | vendor.braze.body.facebook.likes.invalid |
docs |
facebook.likes[] |
optional | The vendor documents `facebook.likes[]` in the request contract. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.facebook.likes[].invalid |
docs |
facebook.num_friends |
optional | The vendor documents `facebook.num_friends` in the request contract. Body scope: attributes[]. Native JSON type: integer. Minimum numeric value: 0. | vendor.braze.body.facebook.num_friends.invalid |
docs |
twitter.id |
optional | The vendor documents `twitter.id` in the request contract. Body scope: attributes[]. Native JSON type: integer. Minimum numeric value: 0. | vendor.braze.body.twitter.id.invalid |
docs |
twitter.followers_count |
optional | The vendor documents `twitter.followers_count` in the request contract. Body scope: attributes[]. Native JSON type: integer. Minimum numeric value: 0. | vendor.braze.body.twitter.followers_count.invalid |
docs |
twitter.friends_count |
optional | The vendor documents `twitter.friends_count` in the request contract. Body scope: attributes[]. Native JSON type: integer. Minimum numeric value: 0. | vendor.braze.body.twitter.friends_count.invalid |
docs |
twitter.statuses_count |
optional | The vendor documents `twitter.statuses_count` in the request contract. Body scope: attributes[]. Native JSON type: integer. Minimum numeric value: 0. | vendor.braze.body.twitter.statuses_count.invalid |
docs |
_merge_objects |
optional | True deep-merges nested objects. False or omission replaces them. Body scope: attributes[]. Native JSON type: boolean. | vendor.braze.body._merge_objects.invalid |
docs |
alias_name |
optional | The published request contract defines alias_name as string. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.alias_name.invalid |
docs |
alias_label |
optional | The published request contract defines alias_label as string. Body scope: attributes[]. Native JSON type: string. | vendor.braze.body.alias_label.invalid |
docs |
body.attribute_one_primary_identifier |
required | Braze forbids external_id and user_alias together in one object. Use the alias creation endpoint to attach an alias to a known external ID. Body scope: attributes[]. Fix: Send one primary identifier. `email` and `phone` may ride alongside it as attributes. | vendor.braze.body.attribute_one_primary_identifier |
docs |
body.attribute_needs_an_identifier |
required | Braze requires a user identifier unless push_token_import is true for an anonymous push token import. Body scope: attributes[]. Fix: Add one of the documented identifiers to the object. | vendor.braze.body.attribute_needs_an_identifier |
docs |
body.attribute_alias_requires_name_and_label |
required | A `user_alias` object is missing `alias_name` or `alias_label`. Braze documents both as required, each at most 236 bytes. Body scope: attributes[]. Fix: Set `user_alias.alias_name` and `user_alias.alias_label`. | vendor.braze.body.attribute_alias_requires_name_and_label |
docs |
body.anonymous_push_token_required |
required | The request does not satisfy the documented anonymous push token required requirement. Body scope: attributes[]. | vendor.braze.body.anonymous_push_token_required |
docs |
body.anonymous_push_ids_forbidden |
required | The request does not satisfy the documented anonymous push ids forbidden requirement. Body scope: attributes[]. | vendor.braze.body.anonymous_push_ids_forbidden |
docs |
body.language_registry |
recommended | The language is absent from the current Braze supported-language list. It may be ignored. Body scope: attributes[]. | vendor.braze.body.language_registry |
docs |
root |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
inc |
optional | The published request contract defines inc as integer. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: integer. | vendor.braze.body.inc.invalid |
docs |
add |
optional | The published request contract defines add as array. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: array. | vendor.braze.body.add.invalid |
docs |
remove |
optional | The published request contract defines remove as array. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: array. | vendor.braze.body.remove.invalid |
docs |
add[] |
optional | The published request contract defines add[] as ['string', 'number', 'boolean']. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: string or number or boolean. | vendor.braze.body.add[].invalid |
docs |
remove[] |
optional | The published request contract defines remove[] as ['string', 'number', 'boolean']. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: string or number or boolean. | vendor.braze.body.remove[].invalid |
docs |
$add |
optional | The published request contract defines $add as array. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: array. | vendor.braze.body.$add.invalid |
docs |
$remove |
optional | The published request contract defines $remove as array. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: array. | vendor.braze.body.$remove.invalid |
docs |
$update |
optional | The published request contract defines $update as array. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: array. | vendor.braze.body.$update.invalid |
docs |
$add[] |
optional | The published request contract defines $add[] as object. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: object. | vendor.braze.body.$add[].invalid |
docs |
$remove[] |
optional | The published request contract defines $remove[] as object. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: object. | vendor.braze.body.$remove[].invalid |
docs |
$update[] |
optional | The published request contract defines $update[] as object. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: object. | vendor.braze.body.$update[].invalid |
docs |
root |
optional | The published request contract defines the selected value as object. Body scope: attributes[].*.$remove[]. Native JSON type: object. | vendor.braze.body.root.invalid |
docs |
$identifier_key |
required | The published request contract defines $identifier_key as string. Body scope: attributes[].*.$remove[]. Native JSON type: string. | vendor.braze.body.$identifier_key.missingvendor.braze.body.$identifier_key.invalid |
docs |
$identifier_value |
required | The published request contract defines $identifier_value as ['string', 'number', 'boolean', 'array', 'object']. Body scope: attributes[].*.$remove[]. Native JSON type: string or number or boolean or array or object. | vendor.braze.body.$identifier_value.missingvendor.braze.body.$identifier_value.invalid |
docs |
root |
optional | The published request contract defines the selected value as object. Body scope: attributes[].*.$update[]. Native JSON type: object. | vendor.braze.body.root.invalid |
docs |
$identifier_key |
required | The published request contract defines $identifier_key as string. Body scope: attributes[].*.$update[]. Native JSON type: string. | vendor.braze.body.$identifier_key.missingvendor.braze.body.$identifier_key.invalid |
docs |
$identifier_value |
required | The published request contract defines $identifier_value as ['string', 'number', 'boolean', 'array', 'object']. Body scope: attributes[].*.$update[]. Native JSON type: string or number or boolean or array or object. | vendor.braze.body.$identifier_value.missingvendor.braze.body.$identifier_value.invalid |
docs |
$new_object |
required | The published request contract defines $new_object as object. Body scope: attributes[].*.$update[]. Native JSON type: object. | vendor.braze.body.$new_object.missingvendor.braze.body.$new_object.invalid |
docs |
root |
optional | The published request contract defines the selected value as ['array', 'string', 'number', 'boolean', 'object', 'null']. Body scope: attributes[].*. Applies when {"kind":"all","conditions":[{"kind":"json_type","param":"","json_type":"array"},{"kind":"not","condition":{"kind":"json_type","param":"[0]","json_type":"object"}}]}. Value diagnostic severity: warning. Native JSON type: array or string or number or boolean or object or null. Maximum array items: 500. | vendor.braze.body.root.invalid |
docs |
[0] |
optional | Body scope: attributes[].*. | docs | |
[] |
optional | The published request contract defines [] as ['string', 'number', 'boolean']. Body scope: attributes[].*. Applies when {"kind":"not","condition":{"kind":"json_type","param":"[0]","json_type":"object"}}. Native JSON type: string or number or boolean. | vendor.braze.body.[].invalid |
docs |
[0] |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"[0]","json_type":"object"}. | docs | |
[] |
optional | The published request contract defines [] as object. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"[0]","json_type":"object"}. Native JSON type: object. | vendor.braze.body.[].invalid |
docs |
root |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
nested_values… |
optional | The published request contract defines nested_values as ['string', 'number', 'boolean', 'array', 'object']. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: string or number or boolean or array or object. Maximum decoded characters: 255. | vendor.braze.body.nested_values.invalid |
docs |
invalid_nested_names… |
forbidden | Nested custom keys have at most 255 characters and cannot contain spaces, periods, or dollar signs. Documented mutation and time operators are reserved exceptions. Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | vendor.braze.body.invalid_nested_names.forbidden |
docs |
$add |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$remove |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$update |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$identifier_key |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$identifier_value |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$new_object |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$time |
optional | Body scope: attributes[].*. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
root |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
nested_values… |
optional | The published request contract defines nested_values as ['string', 'number', 'boolean', 'array', 'object']. Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. Native JSON type: string or number or boolean or array or object. Maximum decoded characters: 255. | vendor.braze.body.nested_values.invalid |
docs |
invalid_nested_names… |
forbidden | Nested custom keys have at most 255 characters and cannot contain spaces, periods, or dollar signs. Documented mutation and time operators are reserved exceptions. Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | vendor.braze.body.invalid_nested_names.forbidden |
docs |
$add |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$remove |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$update |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$identifier_key |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$identifier_value |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$new_object |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
$time |
optional | Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"","json_type":"object"}. | docs | |
root |
optional | The published request contract defines the selected value as ['string', 'number', 'boolean', 'array', 'object']. Body scope: attributes[].*.**. Native JSON type: string or number or boolean or array or object. | vendor.braze.body.root.invalid |
docs |
$time |
optional | Nested dates use a non-null $time string. Calendar parsing must accept all documented Braze formats. Body scope: attributes[].*.**. Native JSON type: string. | vendor.braze.body.$time.invalid |
docs |
push_token_import |
optional | Body scope: attributes[]. Applies when {"kind":"value_in","param":"push_token_import","values":["true"]}. | docs | |
push_tokens |
optional | The published request contract defines push_tokens as array. Body scope: attributes[]. Applies when {"kind":"value_in","param":"push_token_import","values":["true"]}. Native JSON type: array. Minimum array items: 1. | vendor.braze.body.push_tokens.invalid |
docs |
root |
optional | Custom object and object-array attribute names share the published nested-key grammar. Scalar attribute names keep their own semantics. Body scope: attributes[].*. Applies when {"kind":"any","conditions":[{"kind":"json_type","param":"","json_type":"object"},{"kind":"json_type","param":"[0]","json_type":"object"}]}. Maximum key length: 255. Member name pattern: ^[^ .$]*$. | vendor.braze.body.root.invalid |
docs |
[0] |
optional | Body scope: attributes[].*. | docs | |
properties |
optional | Advisory interpretation of the published KB property size limit using compact UTF-8 JSON and a conservative KiB ceiling. Vendor serialization and KB units are not specified. Body scope: purchases[]. Applies when {"kind":"json_type","param":"properties","json_type":"object"}. Presence diagnostic severity: warning. Evidence: heuristic. Native JSON type: object. Maximum compact JSON bytes: 51200. | vendor.braze.body.properties.invalid |
docs |
properties |
optional | Advisory interpretation of the published KB property size limit using compact UTF-8 JSON and a conservative KiB ceiling. Vendor serialization and KB units are not specified. Body scope: events[]. Applies when {"kind":"all","conditions":[{"kind":"json_type","param":"properties","json_type":"object"},{"kind":"json_type","param":"properties.*","json_type":["array","object"]}]}. Presence diagnostic severity: warning. Evidence: heuristic. Native JSON type: object. Maximum compact JSON bytes: 102400. | vendor.braze.body.properties.invalid |
docs |
properties.* |
optional | Body scope: events[]. | docs | |
root |
optional | Advisory interpretation of the 100 KB object/object-array limit using compact UTF-8 JSON. Incremental mutation size also depends on the existing profile state. Body scope: attributes[].*. Applies when {"kind":"any","conditions":[{"kind":"json_type","param":"","json_type":"object"},{"kind":"json_type","param":"[0]","json_type":"object"}]}. Presence diagnostic severity: warning. Evidence: heuristic. Maximum compact JSON bytes: 102400. | vendor.braze.body.root.invalid |
docs |
[0] |
optional | Body scope: attributes[].*. | docs | |
$time |
optional | Explicit nested dates use published date representations and years0 through3000. Validate calendar/clock fields while preserving unspecified ISO breadth, timezone fallback and opaque TZD behavior. Body scope: attributes[].*.**. Applies when {"kind":"json_type","param":"$time","json_type":"string"}. Value diagnostic severity: warning. | vendor.braze.body.$time.emptyvendor.braze.body.$time.invalid |
docs |
method |
required | This published ingestion operation uses HTTP POST. Complete HTTP capture contract. Native JSON type: string. | vendor.braze.http.method.missingvendor.braze.http.method.emptyvendor.braze.http.method.invalid |
docs |
content_type |
recommended | Use a published request media type. Complete HTTP capture contract. Presence diagnostic severity: warning. Value diagnostic severity: warning. Native JSON type: string. | vendor.braze.http.content_type.missingvendor.braze.http.content_type.emptyvendor.braze.http.content_type.invalid |
docs |
body |
required | The request body is a JSON object. Complete HTTP capture contract. Native JSON type: object. | vendor.braze.http.body.missingvendor.braze.http.body.invalid |
docs |
headers.authorization |
required | This endpoint requires the documented authentication header. Complete HTTP capture contract. Native JSON type: string. | vendor.braze.http.headers.authorization.missingvendor.braze.http.headers.authorization.emptyvendor.braze.http.headers.authorization.invalid |
docs |
Validate a payload
pixellint validate json @payload.json --rulepack vendor/braze
Try this failing payload in the playground. An example with a validation finding.
{
"attributes": [
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
},
{
"external_id": "synthetic-user",
"tier": "free"
}
],
"events": [],
"purchases": []
}
cargo install pixellint
·
npm install pixellint