10DLC - Register a brand via the API

Quick access:

• Register a new 10DLC brand
• What happens next?

Please make sure you have read our 10DLC brand registration guide before proceeding.

You can find the complete 10DLC API description on this page.

Register a new 10DLC brand

Send the request with the information of your brand, please follow the recommendations of our brand registration guide to ensure the best results:

To register a Sole Proprietor brand:

POST https://api-eu.vonage.com/v1/10dlc/brands
{
  "account_id": "abcd1234",                // The API key of your Vonage account
  "entity_type": "SOLE_PROPRIETOR",
  "first_name": "John",
  "last_name": "Smith",
  "display_name": "Smith Haircuts",        // Your entity's name (known to customers)
  "company_name": "Smith Haircuts",        // Your entity's legal name
  "alt_business_id_type": "DUNS",          // (optional)
  "alt_business_id": "150483782",          // (optional)
  "phone": "15556660001",                  // Your entity's registered phone number
  "mobile_phone": "12023339999"            // Your active U.S. or Canadian mobile phone
  "street": "23 Main Street",              // Your entity's registered address
  "city": "Holmdel",
  "state": "NJ",
  "postal_code": "07733",
  "country": "US",
  "email": "John@smith-haircuts.com",      // Your professional email address
  "website": "https://smith-haircuts.com", // Your entity website (optional)
  "vertical": "RETAIL",
}

All attributes are required, except when specified otherwise.

Additional checks are performed by The Campaign Registry (TCR) when submitting a sole proprietor brand. You might get specific errors returned when submitting sole proprietor brands failing these additional checks.

To register a Public Profit brand:

POST https://api-eu.vonage.com/v1/10dlc/brands
{
  "account_id": "abcd1234",                 // The API key of your Vonage account
  "entity_type": "PUBLIC_PROFIT",
  "display_name": "Vonage",                 // Your company's name (known to customers)
  "company_name": "Vonage Holding Corp.",   // Your company's legal name
  "ein": "20-1111111",                      // Your company's identification information
  "ein_issuing_country": "US",              // (optional - defaults to country)
  "alt_business_id_type": "DUNS",           // (optional)
  "alt_business_id": "150483782",           // (optional)
  "phone": "15556660001",                   // Your company's registered phone number
  "street": "23 Main Street",               // Your company's registered address
  "city": "Holmdel",
  "state": "NJ",
  "postal_code": "07733",
  "country": "US",
  "email": "support@vonage.com",            // Your company's support email address
  "stock_symbol": "VG",                     // Your company's stock symbol
  "stock_exchange": "NASDAQ",               // The stock exchange where your company is listed
  "website": "https://vonage.com",          // Your entity website (optional)
  "vertical": "TECHNOLOGY",
}

All attributes are required, except when specified otherwise.

To register any other brand:

POST https://api-eu.vonage.com/v1/10dlc/brands
{
  "account_id": "abcd1234",                 // The API key of your Vonage account
  "entity_type": "PRIVATE_PROFIT",          // Can also be "NON_PROFIT"/"GOVERNMENT"
  "display_name": "Riverside Restaurant",   // Your entity's name (known to customers)
  "company_name": "Riverside Restaurant",   // Your entity's legal name
  "ein": "20-1111111",                      // Your brand identification information
  "ein_issuing_country": "US",              // (optional - defaults to country)
  "alt_business_id_type": "DUNS",           // (optional)
  "alt_business_id": "150483782",           // (optional)
  "phone": "15556660001",                   // Your entity's registered phone number
  "street": "23 Main Street",               // Your entity's registered address
  "city": "Holmdel",
  "state": "NJ",
  "postal_code": "07733",
  "country": "US",
  "email": "bookings@riverside.com",        // Your entity's support email address
  "website": "https://riverside.com",       // Your entity website (optional)
  "vertical": "HOSPITALITY",
}

All attributes are required, except when specified otherwise.

Returned payload

The successful completion of the request returns a 201 code, with the payload of the brand submitted.

The brand registration is a two-steps process. First the registration of the brand itself. Then, The Campaign Registry (TCR) proceeds to a basic verification of the brand registered. This basic verification amounts to a charge of $4, applied to any successful brand registration.

Note:

• The brand identity status will return "pending" until the basic verification completes. If successful, the "verified" identity status will allow you to register "low volume mixed" campaigns.
• Sole proprietor brands will need to complete an OTP verification of the mobile phone provided during the registration to complete the verification and allow registering a "sole proprietor" campaign.

Congratulations, you have completed the registration of your 10DLC brand!

What happens next?

If your brand's basic verification failed, follow those steps:

• Make sure that all the information provided is correct. The information must be the same as it appears in the official records of your country's registry.
• If you would like to request a new basic verification, please use the revet endpoint. Note that this operation costs $4 each time.
• If you cannot successfully verify your brand, you must proceed to an external vetting for your brand

For more information, please check our brand verification requirements.

Back to 10DLC brand registration guide

Back to Guide of guides