60368: Challenge details invalid or not provided
VERIFY
ERROR
Twilio returns this error when a Verify Challenge request does not include valid details, or when the details payload does not match the expected structure for the Challenge being created. For push challenges, details.message is required and details.fields must follow the documented format and limits.
- The request creates a push Challenge without
details.message, which is required whenfactor_typeispush. - The
details.fieldspayload is not sent as a list of objects withlabelandvaluepairs. - One or more
details.fieldsentries exceed the supported limits. Eachlabelcan be up to 36 characters, eachvaluecan be up to 128 characters, and you can send up to 20 fields. - The
details.messagevalue exceeds the supported maximum of 256 characters. - The request sends context in
hiddenDetailsbut omits the user-facingdetailsvalues needed for the Challenge.hiddenDetailsis separate from the Challenge details shown to the end user.
- If you are creating a push Challenge, include
details.messagein the request body. Use it for the message shown when the push notification arrives. - If you send
details.fields, structure each item as a field object withlabelandvalue. Match the Create a Challenge request format shown in the API reference. - Keep all Challenge detail values within the documented limits. Limit
details.messageto 256 characters, each fieldlabelto 36 characters, each fieldvalueto 128 characters, and the total number of fields to 20. - Send
hiddenDetailsonly for context that should not be shown to the user. Put user-facing challenge content indetails. - Compare your request against the Verify Challenge creation examples and update your request body so the parameter names and payload shape match the documented API.