Start a carrier registration
Starts the US carrier registration that a number needs before SMS
delivers: 10DLC (standard company or sole-proprietor) or toll-free
verification. 10DLC needs brand + campaign; toll-free needs
tollFree. Approval is asynchronous; poll
GET /v1/sms/registrations/{id} (sole-prop registrations first need
the OTP step: a code is texted to the brand's mobile number, submit it
via /verify-otp).
Already have an approved registration? Add another number to it with
POST /v1/phone-numbers/{id}/sms/reuse-registration instead
of registering (and paying the carrier brand fee) again.
Rather have your client fill in the legal business details? Create a
share link with POST /v1/sms/registrations/share.
API key authentication - use your Zernio API key as a Bearer token
In: header
"standard_10dlc" | "sole_prop_10dlc" | "toll_free"Your numbers this registration covers.
1 <= itemsRequired for 10DLC. The legal entity behind the traffic (TCR brand).
Required for 10DLC. What you'll send and how recipients opt in/out.
Required for toll_free.
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.sms.startSmsRegistration({ body: { registrationType: 'standard_10dlc', phoneNumbers: [ 'string', ], },});console.log(data);{
"registrationId": "string",
"status": "pending",
"awaitingOtp": true
}{
"error": "Unauthorized"
}Create a registration share link POST
Creates a single-use, expiring link (valid 7 days) that lets someone else (whoever has the legal business details) fill in the carrier registration form for one of your numbers, without a Zernio login. The registration is created under your account once the form is submitted.
Submit the sole-prop OTP POST
Completes sole-proprietor 10DLC brand verification by submitting the one-time PIN texted to the brand's mobile number. On success the registration continues to campaign creation automatically.