Enable SMS on a number
Turns on SMS for one of your numbers. The number's real carrier
capability is checked first: some number types can't do SMS at all
(smsCapable: false), and a number still provisioning at the carrier
returns notReady: true (try again once provisioning finishes).
US numbers additionally need a carrier registration before messages deliver; the response tells you which path applies:
alreadyRegistered: true: a prior registration still covers this number; SMS was simply reactivated.reusableset: you have an approved registration this number can join in one click viaPOST /v1/phone-numbers/{id}/sms/reuse-registration(no new brand/campaign, no extra carrier fee).needsRegistration: trueand noreusable: start one viaPOST /v1/sms/registrations.
Idempotent: re-running re-attempts any carrier-side setup that failed.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Phone number record ID (from GET /v1/phone-numbers).
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.enableSmsOnNumber({ path: { id: 'abc123', },});console.log(data);{
"enabled": true,
"id": "string",
"phoneNumber": "string",
"isActive": true,
"country": "string",
"smsCapable": true,
"mmsCapable": true,
"domesticOnly": true,
"notReady": true,
"needsRegistration": true,
"alreadyRegistered": true,
"registrationStatus": "pending",
"reusable": {
"registrationId": "string",
"status": "string"
},
"message": "string"
}{
"error": "Unauthorized"
}Disable SMS on a number DELETE
Turns off SMS for the number (deactivates its SMS account). The carrier registration is untouched, so re-enabling later just reactivates it, with no re-registration.
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.