pixellint

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

Hosts
braze.com, braze.eu
Paths
/users/track
Vendor docs
www.braze.com/docs/api/endpoints/user_data/post_user_track/

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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.braze.body.name.empty
vendor.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.missing
vendor.braze.body.time.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.braze.body.product_id.empty
vendor.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.missing
vendor.braze.body.currency.empty
vendor.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.missing
vendor.braze.body.price.empty
vendor.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.empty
vendor.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.missing
vendor.braze.body.time.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.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.missing
vendor.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.missing
vendor.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.missing
vendor.braze.body.subscription_groups[].subscription_state.empty
vendor.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.missing
vendor.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.missing
vendor.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.missing
vendor.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.missing
vendor.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.missing
vendor.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.empty
vendor.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.missing
vendor.braze.http.method.empty
vendor.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.missing
vendor.braze.http.content_type.empty
vendor.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.missing
vendor.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.missing
vendor.braze.http.headers.authorization.empty
vendor.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