SMS on Speko
Receive and send text messages on your Speko phone numbers: who can send, carrier registration, timelines, and APIs.
Speko provides durable, compliant SMS messaging over Telnyx-managed US 10DLC numbers.
Who can receive and who can send
Every workspace receives SMS. Texts to your Speko-managed numbers land in the shared inbox, in the /v1/sms read endpoints, in the MCP tools, and in sms.* webhooks. Speko attaches each number to your workspace's own Telnyx messaging profile, numbers bought before Speko offered SMS included. You don't need to request anything.
Sending starts once one of your numbers is on an approved 10DLC campaign:
- Carrier registration (10DLC). US and Canadian carriers require it from every business that sends application-driven SMS from a local number. Register your business or yourself as a sole proprietor, self-serve from the dashboard or the API. If Speko assigned a campaign to your workspace, or enabled its shared campaign for you, that campaign counts too.
- Number assignment. Assign a number to the approved campaign on the Numbers tab.
A Canadian number needs neither step. It sends as soon as it is on your messaging profile, and it texts Canadian numbers only. See Canadian numbers.
GET /v1/sms/capabilities and features.smsSending on GET /v1/organization report whether the workspace can send. Until it can, the dashboard hides the composer and batch sends, and the API refuses sends, replies, batches, PATCH /v1/sms/settings, and new consent records with 403 and code SMS_SENDING_NOT_APPROVED. Once it can, you can send immediately or schedule messages.
Prerequisites
Before you can register:
- Credits for the carrier fees. Telnyx's 10DLC fees are charged at cost from your balance; see registration fees. Sending turns on once a number is assigned to your approved campaign.
- A Speko-managed phone number. Buy one under Phone Numbers (requires business verification). Numbers imported over a SIP trunk keep messaging through your own carrier and can't be registered here.
- Your business details. Legal name exactly as registered with the IRS, EIN (US tax ID), business address, website, and an authorized contact. Sole proprietors register without an EIN.
The carriers verify your legal name against the IRS record for your EIN — they must match exactly. A recent rename or a DBA in the legal-name field is the most common reason verification fails.
How long it takes
| Step | Typical time |
|---|---|
| Brand identity verification | Minutes to a few hours |
| Campaign carrier review (TCR) | 1-7 business days |
| Number assignment | Minutes |
| End to end | Plan for about a week |
If a step sits unusually long or gets rejected, contact the Speko team — we work with the carrier's compliance queue directly and can escalate a submitted campaign.
The three registration steps
Registration lives at Settings → SMS Compliance:
| Step | Where | What it is |
|---|---|---|
| 1. Brand | Brand tab | Your verified business identity, submitted once |
| 2. Campaign | Campaign tab | What you send and how recipients consent |
| 3. Numbers | Numbers tab | Attach your numbers to the approved campaign |
Register (10DLC)
Step-by-step walkthrough of brand, campaign, and number assignment.
Registration API
Automate registration with the /v1/sms/10dlc endpoints.
Send messages
Single, batch, scheduled, status, and cancellation APIs.
Shared inbox
Human assignment, notes, agent takeover, and live updates.
Consent
Consent records, quiet hours, STOP/START, and suppression.
Events
Signed customer webhooks and the dashboard event stream.
Build a phone agent
Buy a number, assign an agent, and handle calls end to end.