TWtwilio
TrusthubV1A2PBrandRegistrations

Create a new A2P Brand Registration and initialize an embedded compliance session.

Changed on

Create a new A2P Brand Registration and initialize an embedded compliance session.

post/v1/A2PBrandRegistrations

Request

  • Base URL
    https://trusthub.twilio.com
  • URL
    https://trusthub.twilio.com/v1/A2PBrandRegistrations
  • Auth
    HTTP basic

Request body

brandType'STANDARD' | 'SOLE_PROPRIETOR' required

The type of brand being registered.

themeSetIdstring

Theme ID for styling the inquiry form.

friendlyNamestring

A human-readable name for the brand registration.

notificationEmailstring email required

The email address to receive notifications about the registration.

businessNamestring

The legal name of the business.

businessRegistrationAuthoritystring

The authority with which the business is registered.

businessRegistrationNumberstring

The business registration number (e.g., EIN, CBN, ACN). Maximum 21 characters.

businessIndustrystring

The industry of the business.

businessWebsitestring uri

The business website URL (must use https://).

businessTypestring

The type of business entity.

businessStockSymbolstring

The stock symbol for publicly traded companies.

businessStockExchangestring

The stock exchange where the business is listed.

businessTaxExemptStatusstring

Nonprofit/political organization tax-exempt status per the U.S. tax code (e.g. 501c3, 501c1, 527). A value of 527 (political organization) requires a Campaign Verify token in brandExternalVettingToken.

brandExternalVettingTokenstring

Campaign Verify token for externally vetted brands.

businessStreetAddressstring

The street address of the business.

businessStreetAddress2string

Additional street address information.

businessCitystring

The city of the business.

businessStateProvinceRegionstring

The state, province, or region of the business.

businessPostalCodestring

The postal code of the business.

businessCountrystring

The two-letter ISO country code of the business.

businessContactFirstNamestring

The first name of the business contact.

businessContactLastNamestring

The last name of the business contact.

businessContactEmailstring email

The email address of the business contact.

businessContactPhonestring phone-number

The phone number of the business contact in E.164 format.

authorizedContactVerificationEmailstring email

The email address for authorized contact verification.

authorizedContactMobilePhoneNumberE164string phone-number

The mobile phone number for authorized contact in E.164 format.

isTestboolean

Whether this is a test brand registration.

skipAutomaticSecVetboolean

Whether to skip automatic secondary vetting.

Example request

{
  "businessTaxExemptStatus": "527"
}

Response

Created

idstring nullable

The unique A2P Brand or Campaign Registration identifier, formatted as tri1.us1.account.AC.../registration.BU....

sessionIdstring nullable

The Persona inquiry ID used to start the embedded compliance session.

sessionTokenstring nullable

The Persona session token for embedding the compliance UI. Expires in 24 hours.

Changes