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

30701: Brand Registration Failure: Invalid input parameters

Twilio Messaging DocumentationMessaging

Description

description page anchor

Your Brand registration request includes one or more fields that do not pass validation. Review the specific field names and validation messages returned with the error, then correct those inputs before you resubmit the Brand. Common validation failures include length limits, invalid enum values, country-specific address checks, invalid phone number formatting, and invalid email addresses.

(information)

Info

This error occurs during Brand registration, before you can create a Campaign. For help diagnosing Brand-level failures, see Troubleshooting U.S. A2P Brand registration failures.

Possible causes

possible-causes page anchor
  • A text field exceeded the allowed length for that property, such as friendly_name, business_name, business_registration_number, first_name, last_name, street, city, email, stock_ticker, or website_url.
  • phone_number or mobile_phone_number was not provided in E.164 format.
  • An address field failed validation. This can happen when street, city, region, postal_code, or iso_country does not form a valid address for the country you submitted. For U.S. and Canadian addresses, region should use the two-letter state or province abbreviation.
  • email was malformed, used an unknown domain, used a disposable domain, or otherwise failed email validation.
  • An enum field used an unsupported value, such as stock_exchange or business_industry.
  • The invalid value is stored in the customer profile or related registration data used to create the Brand, so the Brand submission continues to fail until that underlying data is corrected.
  • Review the error details for the exact field names that failed validation, then update only those properties and resubmit the Brand registration.
  • Keep each submitted value within the allowed length for that field. If you send enum fields such as stock_exchange or business_industry, use only supported values.
  • Format contact phone numbers in E.164, for example +12025550123.
  • Use a well-formatted email address with a valid, non-disposable domain.
  • Verify that the business address is complete and valid. Use the correct street, city, matching postal_code, a two-letter region value where required, and a two-letter iso_country code.
  • If the invalid data is in the customer profile or trust bundle associated with the Brand, update that underlying record first, then resubmit or update the Brand registration.

Invalid phone number format

invalid-phone-number-format page anchor
(warning)

Warning

The following value would be rejected:

phone_number: 555-012-3456

Phone numbers must use E.164 format. Local formats, dashes, or missing country codes cause validation failures.

(information)

Info

The following value would pass validation:

phone_number: +15550123456

Passes because it uses E.164 format with the country code prefix.

(warning)

Warning

The following values would be rejected:

region: California, postal_code: 9410

U.S. addresses require a two-letter state abbreviation and a valid postal code.

(information)

Info

The following values would pass validation:

region: CA, postal_code: 94105, iso_country: US

Passes because the region uses the two-letter abbreviation and all address fields form a valid combination.