Zernio
APIFor you
Zernio
APIFor you
Platforms

SMS

Overview

Set up

Carrier RegistrationSender IDs

Messaging

Sending

Reference

Limits & Errors
Dashboard
OverviewPlatformsAPI ReferenceResources
SMS

Limits & Errors

SMS and MMS message limits, sender ID rules, what you cannot send, and the errors you will meet, each with its fix.


Limits

LimitValue
TextAt most 10 segments (1,530 GSM-7 or 670 unicode characters)
Segment sizeGSM-7: 160 characters, or 153 per part of a multi-part message. UCS-2 (emoji, non-Latin scripts): 70, or 67 per part
MMS mediaUp to 10 public mediaUrls per message; text is optional
Broadcast attachmentsUp to 10 public http(s) URLs with no redirects; JPEG, PNG, GIF, WEBP, MP4 or 3GPP under 1 MB
SchedulingsendAt as ISO 8601 with offset, in the future
Opt-out listlimit defaults to 500, at most 5,000, most recent first, no cursor
DestinationsOnly the destinations in the SMS price list; others are blocked at send time
Sender ID name3 to 11 characters: letters, digits, spaces, at least one letter
Sender IDs per team1,000 active
Sender ID daily budget500 messages a day by default (level 1), then 2,000, 10,000 or 25,000 on request; shared across names, reset at midnight UTC
Sole-proprietor OTPA new code at most once a minute
Opt-in proof uploadPNG, JPG, WebP, GIF or PDF, up to 4 MB
Hosted registration linkSingle use, valid 7 days

What you cannot do

SMS on Zernio does not allow:

  • Delivering from a US number before its carrier registration is approved
  • Texting from a number that is not SMS-capable (enabled: false with smsCapable: false)
  • Enabling SMS on WhatsApp numbers you brought through embedded signup
  • Messaging a recipient who replied STOP (only they can re-subscribe, by replying START)
  • Receiving replies on a sender ID
  • Sending MMS from a sender ID
  • Sending from a sender ID to the US, Canada or Puerto Rico
  • Claiming a sender ID name for your team alone (names are not exclusive)
  • Appealing a brand-level rejection (correct the brand details and re-verify instead)
  • Appealing a toll-free verification (/appeal covers 10DLC campaigns only)
  • Quoting an SMS price before sending (messages are carrier-rated after they are sent)

Common errors

StatusCodeCauseFix
400missing_required_fieldA registration is missing a required field, named in paramAdd the field and resubmit; run POST /v1/sms/registrations/preflight to catch every gap
422The carrier registry rejected a registration field; param names it when knownCorrect that field and resubmit
404No active SMS-enabled number matches from: you do not own it, or its US registration is not approvedSend from a number you own; wait for approved
409The recipient replied STOPDrop them from your list; they come back only by replying START
409The same Idempotency-Key is still in flightWait for the first request to finish
422The Idempotency-Key was reused with a different bodyUse a new key for a new message
400A broadcast attachment is on a private host, redirects, is over 1 MB, or there are more than 10Fix the attachment list
403alpha_destination_not_supportedA sender ID send to the US, Canada or Puerto RicoSend from a phone number
403mms_not_supportedmediaUrls on a sender ID sendRemove the media, or send from a number
429alpha_daily_limit_reachedToday's sender ID budget is spentWait for the midnight UTC reset, or request a higher level
403sender_id_limit_reachedThe team holds 1,000 active sender IDsContact support to raise it
422The sender ID name impersonates a well-known brand or institutionUse your own brand name
402No payment method is on fileAdd a payment method

A message that fails after it was accepted fires message.failed with the carrier's error code.

Every error uses the envelope in error handling.

Related

  • Carrier registration: 10DLC, toll-free, reuse and appeals.
  • Sending: SMS, MMS, opt-outs and lookups.
  • Sender IDs: branded one-way sends.
  • SMS rates: segment sizes and per-segment prices.
Was this page helpful?

Sending

Send an SMS or MMS from an SMS-enabled number with POST /v1/sms/messages, schedule it, read opt-outs and look up a number's line type.

Meta Ads

Create, boost and measure Facebook and Instagram ads with the Zernio API, using classic or business login.

On this page

LimitsWhat you cannot doCommon errorsRelated