60226: Messages sent to china require friendly_name
VERIFY
ERROR
This error occurs when you start a Verify SMS verification to a phone number in China and the verification message does not include a friendly name. In Verify, the Service friendlyName appears in the body of verification messages, CustomFriendlyName can override that value for an individual verification request, and templates used in China must be registered to your account.
- Your Verify Service does not have a usable
friendlyName, even though Verify uses that value in the body of verification messages. - Your verification request depends on a per-request override, but you did not send
CustomFriendlyNamewhen creating the verification.CustomFriendlyNameoverwrites the existing friendly name in the verification message. - You are using a Verify template for China and the effective message body does not include a friendly name. Verify templates can use
{{friendly_name}}, and Twilio requires template registration before you use a template in China. - You changed the Service configuration or selected a different template, and the final SMS content for China no longer includes the friendly name required for that destination. Verify chooses the message template from the request
TemplateSid, the ServiceDefaultTemplateSid, or the Verify Default template.
- Set or update the Verify Service
friendlyNameto the brand or application name you want to appear in the verification message. Keep it within Verify requirements. It can include letters, numbers, spaces, dashes, and underscores. Do not use phone numbers, special characters, links, or PII. - If you need to override the Service name for a single request, send
CustomFriendlyNamein the Start New Verification API request. - If you use templates for China traffic, select a registered template and confirm the message body includes
{{friendly_name}}. Pass the template withTemplateSidon the verification request or set it as the ServiceDefaultTemplateSid. - Retry the verification after you update the Service or template configuration so the final SMS body sent to the China destination includes a friendly name.