Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Brands

Trigger Brand SMS OTP

Trigger or re-trigger an SMS OTP (One-Time Password) for Sole Proprietor brand verification.

Important Notes:

  • Only allowed for Sole Proprietor (SOLE_PROPRIETOR) brands
  • Triggers generation of a one-time password sent to the mobilePhone number in the brand's profile
  • Campaigns cannot be created until OTP verification is complete
  • US/CA numbers only for real OTPs; mock brands can use non-US/CA numbers for testing
  • Returns a referenceId that can be used to check OTP status via the GET /10dlc/brand/smsOtp/{referenceId} endpoint

Use Cases:

  • Initial OTP trigger after Sole Proprietor brand creation
  • Re-triggering OTP if the user didn't receive or needs a new code
post/10dlc/brand/{brandId}/smsOtp

Path parameters

brandIdstring required
Example:4b20019b-043a-78f8-0657-b3be3f4b4002

The Brand ID for which to trigger the OTP

Request body

pinSmsstring required

SMS message template to send the OTP. Must include @OTP_PIN@ placeholder which will be replaced with the actual PIN

successSmsstring required

SMS message to send upon successful OTP verification

Example request

{
  "pinSms": "Your PIN is @OTP_PIN@",
  "successSms": "Verification successful!"
}

Response

Successful Response

brandIdstring required

The Brand ID for which the OTP was triggered

referenceIdstring required

The reference ID that can be used to check OTP status

Example response

{
  "brandId": "4b20019b-043a-78f8-0657-b3be3f4b4002",
  "referenceId": "OTP4B2001"
}