Create an alphanumeric sender ID
Registers an alphanumeric sender ID (e.g. ZERNIO) — a branded from
for one-way international SMS. No phone number purchase or carrier
registration is needed; once created, pass it as from on
POST /v1/sms/messages.
Constraints: 3-11 characters (letters, digits, spaces; at least one letter). Sends cannot reach the US, Canada, or Puerto Rico, are text-only, and recipients cannot reply. Sender IDs that impersonate well-known brands or institutions are rejected, and an ID already registered by another workspace returns 409 (active sender IDs are globally unique, first-come-first-served). Creating the same sender ID again is a no-op (re-activates it after a delete).
API key authentication - use your Zernio API key as a Bearer token
In: header
The sender ID recipients will see (3-11 letters/digits/spaces, at least one letter, no leading/trailing space).
3 <= length <= 11Response Body
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.sms.createSmsSenderId({ body: { senderId: 'sender_abc123', },});console.log(data);{
"id": "string",
"senderId": "string",
"isActive": true
}{
"error": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}{
"error": "Unauthorized"
}