Carrier Registration

Carrier Registration

US carriers require a number to be registered before it can send SMS. Zernio runs that registration through the API. There are two paths, both handled by startSmsRegistration (POST /v1/sms/registrations):

• 10DLC - for local (10-digit long code) numbers. Standard (company) or sole-proprietor. Needs a brand and a campaign.
• Toll-free verification - for toll-free numbers. Needs the tollFree details.

What registration costs

Registration bills two fees to your usage invoice: a $9 one-time brand fee, and a recurring monthly campaign fee of $20/month for standard 10DLC and toll-free, or $4/month for sole proprietors. The fees are shown before you submit. Reusing an approval on additional numbers incurs no new fees.

Enable SMS on the number first

Before registering, enable SMS on the number (POST /v1/phone-numbers/{id}/sms). Its response tells you whether a reusable, approved registration already exists on your account (see Reuse).

curl -X POST "https://zernio.com/api/v1/phone-numbers/PHONE_NUMBER_ID/sms" \
  -H "Authorization: Bearer YOUR_API_KEY"

Start a 10DLC registration

const { data } = await zernio.sms.startSmsRegistration({
  body: {
    phoneNumbers: ['+14155551234'],
    registrationType: 'standard_10dlc',
    brand: { /* legal business details */ },
    campaign: { /* use case, sample messages */ },
  }
});
console.log(data.registrationId, data.status);

curl -X POST "https://zernio.com/api/v1/sms/registrations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumbers": ["+14155551234"],
    "registrationType": "standard_10dlc",
    "brand": {},
    "campaign": {}
  }'

Carriers reject sparse filings, so several brand and campaign fields are hard requirements: the brand needs a website (sole props may use a social profile URL instead), a full street address (street, city, state, postalCode), and, for company / non-profit / government brands, a business phone. The campaign needs a use case, a description, opt-in/opt-out/help keywords and messages, and two sample messages (sample1 and sample2, 20+ characters each). Missing any of these returns a 400 naming the field.

Reuse an approval (skip the fee)

Carriers charge a brand fee per registration. If you already have an approved 10DLC campaign, do not register again: attach the new number to it with reuseSmsRegistrationForNumber (POST /v1/phone-numbers/{id}/sms/reuse-registration). The number inherits the campaign's approval, with no new brand or campaign and no extra carrier fee.

curl -X POST "https://zernio.com/api/v1/phone-numbers/PHONE_NUMBER_ID/sms/reuse-registration" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"registrationId": "EXISTING_REGISTRATION_ID"}'

Hand the form off (white-label)

If your customer holds the legal business details, shareSmsRegistration (POST /v1/sms/registrations/share) creates a single-use link (valid 7 days) that lets them fill in the registration form with no Zernio login. The registration is created under your account once they submit.

Track and appeal

List registrations with listSmsRegistrations (GET /v1/sms/registrations) and check one with getSmsRegistration (GET /v1/sms/registrations/{id}). If a campaign is rejected, fix the flagged details and appeal with appealSmsRegistration (POST /v1/sms/registrations/{id}/appeal).

Next steps

• Send SMS and MMS once the number is approved