Improvements to Toll-Free Verification Rejection experience

We are excited to announce an enhancement in the Toll-Free Verification process. In our ongoing efforts to streamline and improve the user experience, we now support multiple rejection reasons, new rejection error codes have been added and existing rejection error code descriptions have been improved. These changes are supported in the Toll-Free Verification API, Console, Event Streams - webhooks and email notifications-about a rejected toll-free verification.

With this release, it’s important to note that the Toll-Free Verification API’s LIST, GET and webhook still supports a single rejection reason, but we strongly advise transitioning to the new “rejection_reasons” attribute, so that you pick up all the rejection reasons. 

Previous releases have included this metadata, which you may also find useful when processing a rejection: 

  "rejected_on": "2024-04-05T22:01:58.076Z",

  "edit_expiration": "2024-04-05T22:01:58.076Z",

  "edit_allowed": true,

Additionally, the Twilio-Rejected event webhook now includes the phone number DID: 

  "phonenumber": "+18002225555",

For a detailed list of all toll-free verification error codes please visit Twilio Error and Warning Dictionary.