Undocumented DATA_VALIDATIONS_ERROR (422) when creating items via API — related to Required Columns?

Hi everyone,

We're running into an error when calling the create_item mutation that doesn't appear to be documented in the official Error Handling page, and we'd like to confirm our understanding of it.

The error

When our app creates an item via create_item, we occasionally receive the following error response:

{
  "data": {
    "create_item": null
  },
  "errors": [
    {
      "message": "data_validation_error",
      "locations": [{ "line": 1, "column": 82 }],
      "path": ["create_item"],
      "extensions": {
        "code": "DATA_VALIDATIONS_ERROR",
        "status_code": 422,
        "error_data": [
          {
            "itemId": null,
            "columnIds": ["color_mm145dc6"],
            "message": "'Category' is required"
          }
        ],
        "service": "monolith"
      }
    }
  ]
}

What we think is happening

Based on the error_data, our assumption is that this error occurs because the target board has a Status column ("Category") marked as required, and our create_item mutation is not providing a value for it. The color_ prefix in the column ID suggests it's a Status-type column.

We believe this is tied to monday.com's Required Columns board feature — when a column is set as required, any create_item call that omits a value for that column gets rejected with this DATA_VALIDATIONS_ERROR.

Can someone from the monday.com team confirm this is the case?

The documentation gap

The official Error Handling page lists RecordInvalidException as the only 422 error, described as being related to board subscriber limits. However, DATA_VALIDATIONS_ERROR is a different error code entirely and is not mentioned anywhere in the documentation.

It would be very helpful if this error code were added to the docs, ideally with:

• A description of what triggers it (required column validation, and any other data validations that use this code).
• Guidance on how to handle it (e.g., query the board's column configuration to determine which columns are required before creating items).

Questions for the community

1. Can anyone confirm that DATA_VALIDATIONS_ERROR is specifically triggered by the Required Columns feature?
2. Are there other scenarios (besides missing required column values) that can trigger this error code?
3. Is there an API query to check which columns are marked as required on a board, so we can proactively handle this?

Thanks in advance for any insights!