Skip to contentSkip to navigationSkip to topbar
Page tools
Useful for sharing or LLM
Accelerate development with AI

On this pageProducts used
Looking for more inspiration?Visit the
Error
Application error

22217: Missing Supporting Document field

Twilio Phone Numbers DocumentationPhone Numbers

Description

description page anchor

This error occurs when your Regulatory Bundle is missing a field required for one of its Supporting Documents. A Regulation defines the required End-User and Supporting Document values, and the Supporting Document Type resource returns the fields your document must include.

Possible causes

possible-causes page anchor
  • Your application created or updated a Supporting Document without all required attributes for the selected Supporting Document Type.
  • You relied on hardcoded field requirements instead of retrieving the current Regulation. Regulations can change, and the Regulation resource is designed to provide the values required for regulatory compliance.
  • The applicable Regulation requires one or more Supporting Document fields exposed through fields or detailed_fields, but your bundle omitted one of them.
  • Fetch the applicable Regulation for the phone number country, number type, and end-user type. Set includeConstraints=true so you can review the required document fields before you create or update the bundle.
  • Retrieve the selected Supporting Document Type and provide every field listed in its fields array when you create the Supporting Document.
  • Update or recreate the Supporting Document with complete attributes, then add it to the Regulatory Bundle. If the Regulation requires document proof, upload a supported file type such as JPEG, PNG, or PDF up to 5 MB.

Additional resources

additional-resources page anchor