Add a number to an existing registration
Attaches this number to your existing approved 10DLC campaign instead
of running a fresh registration: the number inherits the campaign's
approval (no new brand or campaign, no extra carrier fee). Enable SMS
on the number first (POST /v1/phone-numbers/{id}/sms; its response
tells you whether a reusable registration exists).
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
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.reuseSmsRegistrationForNumber({ path: { id: 'abc123', },});console.log(data);{
"registrationId": "string",
"status": "pending"
}{
"error": "Unauthorized"
}Look up carrier + line type GET
Carrier name and line type (mobile / landline / voip / toll-free) for a number, plus `smsReachable` (landlines can't receive SMS). Use it to validate recipients before sending. Each lookup is billed by the carrier-data provider, so call it explicitly (e.g. pre-validating an opt-in list), not on every send.
Send an SMS/MMS POST
Sends an SMS (or MMS when `mediaUrls` is set) from one of your SMS-enabled numbers. At least one of `text` / `mediaUrls` is required. Both numbers are normalized to E.164, so `from` matches regardless of formatting and replies thread into the same inbox conversation. US numbers must have an approved carrier registration (`/v1/sms/registrations`) before messages deliver. **Idempotency:** send an `Idempotency-Key` header to make retries safe: same key + same body replays the original response instead of sending a second message; same key + different body returns 422; a key still in flight returns 409.