Toll-free vs short code: choosing your US SMS sender
For US and Canada destinations, Orbit supports three sender classes for A2P SMS: 10DLC long codes, toll-free numbers (8XX), and short codes. Long codes are the baseline — see 10DLC registration. This guide covers the election most teams actually weigh: toll-free vs short code — which one to file, how to file it, and how long each wait runs. The two registrations are different instruments. A toll-free number is yours — you purchase or port it, and the verification form registers a program on it. A short code is a registry lease — you apply for a 3–6 digit code, carriers vet the program, and the lease runs 3, 6, or 12 months. Getting the election wrong costs weeks: a marketing blast filed on toll-free caps out on carrier filtering, and a support line on a short code pays lease fees it never needed.1. The election that decides what you can send
Pick by traffic style first, budget second:Registration vs portability
A toll-free filing has two independent parts that teams conflate:- The number — you own it. Bought in Orbit, or ported in by changing the number’s Responsible Organization (RespOrg) — the SMS/800 (Somos) analogue of a geographic port. Port-in/port-out is a routing change, not a messaging approval.
- The program (TFV) — the carrier review that lifts messaging restrictions. Verification registers content on the number; without it, US carriers treat the traffic as high-risk and throttle or drop it.
2. Q&A on the two scenarios
When does toll-free win? Transactional traffic — order confirmations, delivery updates, appointment reminders, support threads — runs fine on toll-free at moderate volume. The TFV form takes minutes to file and clears in days. If your program is mostly notifications and your recipients opt in at checkout or in-product, toll-free is the cheapest live sender you can run. When does a short code win? Marketing programs with partnerships — affiliate campaigns, franchise promos, partner-branded offers — need throughput and a sender recipients can text back from memory. A nationwide promotional program that outgrows 10DLC vetting tiers, or a CTA printed on packaging and broadcast media, needs the short digit string. Carriers also cut promotional traffic far more slack on an approved short code than on any long or toll-free number. Can I run both? Yes, and many programs should — see section 6. There is no roster constraint between the two registrations; they are independent filings on different senders. What about the rest of the world? This election applies to US/CA destinations. Other countries regulate senders differently — see sender identity by country for the per-destination map.3. Filing the toll-free path
The toll-free verification guide is the full walkthrough — lint samples, submit, track, resubmit. The submission call itself:POST /numbers/tfv-lint on your samples first — it catches the two most-cited rejection classes (disallowed verticals, missing brand/opt-out language) before you burn a submission. Field constraints, use-case categories, and the resubmit flow are in the full TFV guide.
The RespOrg decision
If the toll-free number lives at another provider today,POST /numbers/{id}/tfv-submit refuses — verification requires the number’s administration on this platform. Port the number first, then verify it:
submitted → loa_signed → foc (Somos scheduled activation) → completed. Sign the Letter of Agency in-platform with POST /numbers/porting/toll-free/resporg/:id/loa/sign, then track it with the GET endpoints on the same path. Once the change completes, the number is administration-yours and the TFV form can file.
The reverse — direction: "out" with a newRespOrgId — releases the number to another provider. A RespOrg request is cancellable while it is submitted or loa_signed; once Somos schedules the change, cancellation goes through the losing/gaining RespOrg.
A RespOrg switch changes routing ownership only. It does not substitute for TFV — an unverified ported toll-free number still carries the messaging restrictions until its verification form approves.
4. Filing the short-code application
The short-code application guide walks the lifecycle end-to-end. The filing call:POST /numbers/short-codes/preflight) before you submit — carriers reject roughly a third of first-round briefs on deterministic grounds (SHAFT-C content, public URL shorteners, missing opt-out language), and every rejection restarts the queue.
The unavailability trail
Avanity application asks the registry for a specific 3–6 digit code. If the aggregator comes back with that code unavailable, the vetting outcome is recorded as a rejection with an unavailability reason — the rejection reason tells you whether the problem is the code itself (taken, or not in the CSCA pool) or the brief’s content. Open a new application with a different requestedCode (or switch selection to random and let the registry assign), fix the brief against the linter, and resubmit.
GET /numbers/short-codes/:id keeps the rejectionReason on the application record, and the audit log records short_code.application_rejected — the paper trail for why a code did not land. A registry rejection never removes the old application; it stays queryable so the team can see which codes were tried.
5. Wait expectations
Both filings flare on the onboarding-status timeline — a toll-free phone-number step and a short-code application step each report their current reviewer and ETA. Index your go-live plan to the same page the dashboard is reading:
Plan the blend accordingly: file the toll-free TFV now for the transactional line, open the short-code application the same week, and ride the toll-free sender while the short-code vetting runs.
6. When to blend
The election is not exclusive. Two worked examples:Franchise: marketing on a short code, support on toll-free
A restaurant franchise runs national promo blasts to opted-in members and a reply-based support line. The marketing program files avanity short code — the 5-digit sender is on table tents and receipts, and four messages a week at national scale wants short-code throughput. The support line files TFV on the existing toll-free number — customers call or text the 8XX number, and the moderate volume fits toll-free fine. Two registrations, two senders, each on its own track.
Healthcare: one program, one election
A healthcare provider weighs one messaging program, not two. If outbound volume is transactional — appointment reminders, portal alerts, support replies — and moderate, toll-free TFV clears in days at nearly no cost and the verdict sticks. If the program is a patient-engagement marketing push at national scale, the short-code lease is the right spend. The wrong move is splitting the decision: file on the traffic style you actually run, and re-elect only if the program materially changes.Both elections are tenant-owned filings. Orbit supplies the submission, linter, and tracking surfaces; what you send, and how your recipients opted in, stays your program’s responsibility.
Related
- Toll-free verification — the full TFV loop: lint, submit, track, resubmit.
- Short-code application — the lifecycle from draft to provisioned lease.
- 10DLC registration — the long-code path for US A2P.
- Onboarding status timeline — watch both filings in one view.
- Sender identity by country — the per-destination election map beyond US/CA.