When attempting to create or update a Forms object using the Management API, a 400 Bad Request error might be encountered with the following error message even if the JSON syntax is completely valid.

Payload validation error: 'Data does not match any schemas from 'oneOf'

• Auth0
• Management API

This issue occurs when the data type or structure of a specific property does not meet the API's schema requirements.

When attempting to create or update a Forms object using the Management API, the following error might be encountered even if the JSON syntax is entirely valid. 

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Payload validation error: 'Data does not match any schemas from 'oneOf' on property any_property_name.",
  "errorCode": "invalid_body"
}

Correct JSON syntax prevents "Invalid request payload JSON format" errors. Valid structure ensures the parser accepts the data without syntax exceptions. Instead, the validation fails because the data structure violates the required schema. 

Example Scenario: Updating a Form

When using the Update a form API, adjust the "translations" property. The API requires the "translations" field to be either a single object or null.

[Successful Payloads]

These examples will process successfully because they meet the schema requirements (an object or null):

Success Example 1 (Valid Object):

"translations": {"ja": {}}

Success Example 2 (Valid Null):

"translations": null

[Failed Payloads]

These examples are valid JSON, but they will fail and return the "Data does not match any schemas from "oneOf" on property translations" error because the data type is incorrect.

Failure Example 1:

"translations": ["ja"]

Failure Example 2:

"translations": "ja"

Whenever this specific payload validation error is encountered, look closely at the property name mentioned at the end of the error message, and verify that its data type (string, array, object, boolean, etc.) matches exactly what the API expects.

NOTE: To examine the existing forms by using the Get a Form API. This method works for all forms, whether they were created on the dashboard or via the API.