How to migrate from smsmode to Telnyx
A developer-focused guide to migrating messaging from smsmode to Telnyx: channel and compliance differences, request-format changes, and a step-by-step cutover checklist.
smsmode is a French A2P messaging platform (published by Calade Technologies) offering SMS, RCS, WhatsApp and text-to-speech APIs with data hosted in France. Telnyx is a licensed US telecom carrier running a CPaaS platform for SMS, MMS, RCS, WhatsApp, voice and email over its own private global IP network. On the messaging.dev Score, smsmode rates 53/100 and Telnyx rates 78/100; this guide covers what actually changes when you re-point your sending code from one to the other.
What changes when you switch
Channels. Telnyx is a superset of smsmode’s channel list. You keep SMS, RCS, WhatsApp and voice, and you gain MMS and email. You lose no channels in the move. Neither provider supports Viber, Facebook Messenger, Telegram or Apple Messages for Business, so those stay off the table either way.
Compliance. Both platforms are GDPR-compliant and ISO 27001 certified. Telnyx additionally holds SOC 2 and HIPAA, so you gain two certifications and lose none.
Data residency. smsmode hosts data exclusively in the EU (two ISO 27001 data centers in France) with no region choice. Telnyx offers both US and EU servers, lets you choose data residency, and adds Asia-Pacific and South America regions.
Pricing model. smsmode sells prepaid pay-as-you-go credits on a sliding volume scale, plus optional monthly subscriptions (€9–€499/month); French SMS run from €0.0610 down to €0.0450 excl. VAT. Telnyx is pay-as-you-go billed per message part ($0.004 per outbound US part, plus carrier fees), with volume discounts and custom contracts.
Free credit, SDKs, tooling. smsmode includes 20 free test SMS credits; Telnyx offers no free developer credit. smsmode ships a single SDK (TypeScript/Node.js); Telnyx ships seven (Node.js, Python, Ruby, Go, Java, .NET, PHP). Both rate their docs “high”, and neither offers a sandbox environment. On API surface, smsmode exposes REST, SMPP, SMTP and SFTP, while Telnyx exposes REST and SMPP.
How the request format differs
smsmode quickstart:
curl --location 'https://rest.smsmode.com/sms/v1/messages' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"recipient": { "to": "33600000001" },
"body": { "text": "Hello from smsmode" }
}'
Telnyx quickstart:
curl -X POST https://api.telnyx.com/v2/messages \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"from": "+15551234567",
"to": "+15559876543",
"text": "Hello, world!"
}'
Three things change. The endpoint moves from https://rest.smsmode.com/sms/v1/messages to https://api.telnyx.com/v2/messages. The authentication switches from an API key in the X-Api-Key header to a bearer token in the Authorization: Bearer YOUR_API_KEY header. And the payload flattens: smsmode nests the recipient under recipient.to and the message under body.text, whereas Telnyx puts to, from and text all at the top level. Telnyx also requires an explicit from sender (absent from the smsmode quickstart) and expects E.164 numbers with a leading + (+15559876543), while the smsmode example uses a bare 33600000001.
Migration checklist
- Create a Telnyx account, self-onboard, and generate a bearer API key from the dashboard.
- Map the request fields:
recipient.to→to,body.text→text, and add a top-levelfrom. Normalize all numbers to E.164 format. - Re-point your sending code to
https://api.telnyx.com/v2/messagesand swap theX-Api-Keyheader forAuthorization: Bearer. See the Telnyx quickstart for the native SDK path. - Re-test against live sending — neither provider offers a sandbox, so use a low-volume test number and confirm a 2xx acceptance and real delivery.
- Update your delivery-status webhooks and callback handlers to Telnyx’s event payload format.
- Run both providers in parallel, splitting a share of live traffic to validate delivery and cost.
- Cut over fully once delivery rates and reporting match expectations.
Watch out for
- No free credit. Telnyx has no developer credit; you cannot lean on smsmode’s 20 free test SMS during migration.
- No sandbox. Like smsmode, Telnyx has none, so all validation happens against live sending.
- Fewer countries. Telnyx lists 130 countries covered versus smsmode’s 166 — verify your key destinations.
- Lost API surface. If you rely on smsmode’s SMTP or SFTP interfaces, Telnyx offers only REST and SMPP.
- Retention documentation. smsmode documents EU-only storage with automatic 6-month deletion; Telnyx uses customer-controlled retention but does not publicly document default message-content retention in detail.
For a full side-by-side, see the smsmode vs Telnyx comparison.