Skip to contentSkip to navigationSkip to topbar
Page toolsOn this pageProducts used
Looking for more inspiration?Visit the

60226: Messages sent to china require friendly_name


ERROR: 60226

error-60226 page anchor
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.

Possible causes

possible-causes page anchor
  • 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 CustomFriendlyName when creating the verification. CustomFriendlyName overwrites 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 Service DefaultTemplateSid, or the Verify Default template.
  • Set or update the Verify Service friendlyName to 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 CustomFriendlyName in 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 with TemplateSid on the verification request or set it as the Service DefaultTemplateSid.
  • 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.

Additional resources

additional-resources page anchor