Telnyx SMS API

Carrier-grade SMS API with direct routing. No aggregator markup, no middleman margin. Programmable messaging on infrastructure Telnyx owns end-to-end. [1]

telnyx.com/products/sms-api · By Telnyx · Agent JSON · Suggest an edit · Last verified 2026-06-10 · Source confidence: high

Best for / Avoid if

Best for: AI agents and automation - an agent-ready surface (MCP / llms.txt); Teams needing broad API coverage out of the box; Cost-sensitive teams - low, transparent entry price

Avoid if: You want to try it free before paying

Scores

  • 80 / 100
    Agent friendliness
  • 85 / 100
    Pricing transparency
  • 60 / 100
    Setup speed
  • 80 / 100
    Docs quality
  • 85 / 100
    Procurement ease
  • 100 / 100
    Trust readiness

Scores are computed deterministically from this profile's published, sourced fields (pricing, compliance, capabilities, docs and developer-surface signals) - not from reviews or paid placement. Each axis is 0-100; an unknown signal scores 0 for that axis. Procurement ease is the inverse of buying friction (higher = easier to adopt).

Pricing & procurement

Pricing model
Usage-based [2]
Published pricing
Yes [3]
Free tier
No [4]
Self-serve signup
Yes [5]
Requires sales call
No [6]
Enterprise plan
No [7]
Published prices
PlanItemPerAmountSource
Pay As You GoLocal 10DLC Outbound SMSmessage part$0.004source
Pay As You GoLocal 10DLC Outbound MMSmessage part$0.015source
Pay As You GoLocal 10DLC Inbound SMSmessage part$0.004source
Pay As You GoLocal 10DLC Inbound MMSmessage part$0.005source
Pay As You GoLocal 10DLC Outbound SMSmessage part (next 150M/month)$0.002source
Pay As You GoLocal 10DLC Outbound MMSmessage part (next 150M/month)$0.0135source
Pay As You GoLocal 10DLC Outbound SMSmessage part (next 250M/month)$0.0015source
Pay As You GoLocal 10DLC Outbound MMSmessage part (next 250M/month)$0.011source
Pay As You GoLocal 10DLC Outbound SMSmessage part (next 500M/month)$0.001source
Pay As You GoLocal 10DLC Outbound MMSmessage part (next 500M/month)$0.01source
Pay As You GoLocal 10DLC Outbound SMSmessage part (next 1B/month)$0.0005source
Pay As You GoLocal 10DLC Outbound MMSmessage part (next 1B/month)$0.009source
Pay As You GoLocal 10DLC Inbound SMSmessage part (next 150M/month)$0.002source
Pay As You GoLocal 10DLC Inbound MMSmessage part (next 150M/month)$0.0045source
Pay As You GoLocal 10DLC Inbound SMSmessage part (next 250M/month)$0.0015source
Pay As You GoLocal 10DLC Inbound MMSmessage part (next 250M/month)$0.004source
Pay As You GoLocal 10DLC Inbound SMSmessage part (next 500M/month)$0.001source
Pay As You GoLocal 10DLC Inbound MMSmessage part (next 500M/month)$0.0035source
Pay As You GoLocal 10DLC Inbound SMSmessage part (next 1B/month)$0.0005source
Pay As You GoLocal 10DLC Inbound MMSmessage part (next 1B/month)$0.003source
Pay As You Go1st Point Outbound SMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoAT&T Outbound SMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoAT&T Outbound MMS Carrier Fee (Local 10DLC)message part$0.009source
Pay As You GoC Spire Wireless Outbound SMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoC Spire Wireless Outbound MMS Carrier Fee (Local 10DLC)message part$0.01source
Pay As You GoDigicel Outbound SMS Carrier Fee (Local 10DLC)message part$0.2source
Pay As You GoLleida Outbound SMS Carrier Fee (Local 10DLC)message part$0.04source
Pay As You GoLleida Outbound MMS Carrier Fee (Local 10DLC)message part$0.04source
Pay As You GoShelcomm Outbound SMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoT-Mobile USA Outbound SMS Carrier Fee (Local 10DLC)message part$0.0045source
Pay As You GoT-Mobile USA Outbound MMS Carrier Fee (Local 10DLC)message part$0.01source
Pay As You GoTextnow Peerless Outbound SMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoTextnow Peerless Outbound MMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoU.S. Cellular Outbound SMS Carrier Fee (Local 10DLC)message part$0.005source
Pay As You GoU.S. Cellular Outbound MMS Carrier Fee (Local 10DLC)message part$0.01source
Pay As You GoVerizon Wireless Outbound SMS Carrier Fee (Local 10DLC)message part$0.0045source
Pay As You GoVerizon Wireless Outbound MMS Carrier Fee (Local 10DLC)message part$0.007source
Pay As You GoAT&T Inbound SMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoAT&T Inbound MMS Carrier Fee (Local 10DLC)message part$0.009source
Pay As You GoC Spire Wireless Inbound SMS Carrier Fee (Local 10DLC)message part$0.0035source
Pay As You GoC Spire Wireless Inbound MMS Carrier Fee (Local 10DLC)message part$0.005source
Pay As You GoT-Mobile USA Inbound SMS Carrier Fee (Local 10DLC)message part$0.0025source
Pay As You GoT-Mobile USA Inbound MMS Carrier Fee (Local 10DLC)message part$0.01source
Pay As You GoToll-Free Outbound SMSmessage part$0.0055source
Pay As You GoToll-Free Outbound MMSmessage part$0.016source
Pay As You GoToll-Free Inbound SMSmessage part$0.0055source
Pay As You GoToll-Free Inbound MMSmessage part$0.016source
Pay As You GoAT&T Outbound SMS Carrier Fee (Toll-Free)message part$0.0035source
Pay As You GoAT&T Outbound MMS Carrier Fee (Toll-Free)message part$0.009source
Pay As You GoCarrier Group A Outbound SMS Carrier Fee (Toll-Free)message part$0.0015source
Pay As You GoCarrier Group A Outbound MMS Carrier Fee (Toll-Free)message part$0.002source
Pay As You GoCarrier Group B Outbound SMS Carrier Fee (Toll-Free)message part$0.0035source
Pay As You GoCarrier Group B Outbound MMS Carrier Fee (Toll-Free)message part$0.01source
Pay As You GoT-Mobile USA Outbound SMS Carrier Fee (Toll-Free)message part$0.0045source
Pay As You GoT-Mobile USA Outbound MMS Carrier Fee (Toll-Free)message part$0.01source
Pay As You GoU.S. Cellular Outbound SMS Carrier Fee (Toll-Free)message part$0.0025source
Pay As You GoU.S. Cellular Outbound MMS Carrier Fee (Toll-Free)message part$0.005source
Pay As You GoVerizon Wireless Outbound SMS Carrier Fee (Toll-Free)message part$0.0045source
Pay As You GoVerizon Wireless Outbound MMS Carrier Fee (Toll-Free)message part$0.007source
Pay As You GoAT&T Inbound SMS Carrier Fee (Toll-Free)message part$0.0035source
Pay As You GoAT&T Inbound MMS Carrier Fee (Toll-Free)message part$0.009source
Pay As You GoC Spire Wireless Inbound SMS Carrier Fee (Toll-Free)message part$0source
Pay As You GoT-Mobile USA Inbound SMS Carrier Fee (Toll-Free)message part$0.0025source
Pay As You GoT-Mobile USA Inbound MMS Carrier Fee (Toll-Free)message part$0.01source
Pay As You GoU.S. Cellular Inbound SMS Carrier Fee (Toll-Free)message part$0.0025source
Pay As You GoU.S. Cellular Inbound MMS Carrier Fee (Toll-Free)message part$0.005source
Pay As You GoShort Code Outbound SMSmessage part$0.007source
Pay As You GoShort Code Outbound MMSmessage part$0.018source
Pay As You GoShort Code Inbound SMSmessage part$0.007source
Pay As You GoShort Code Inbound MMSmessage part$0.009source
Pay As You GoShort Code Outbound SMSmessage part (next 4.5M/month)$0.0045source
Pay As You GoShort Code Outbound SMSmessage part (next 20M/month)$0.0025source
Pay As You GoShort Code Outbound SMSmessage part (next 75M/month)$0.0015source
Pay As You GoShort Code Outbound MMSmessage part (next 75M/month)$0.015source
Pay As You GoShort Code Outbound SMSmessage part (next 100M/month)$0.001source
Pay As You GoShort Code Outbound MMSmessage part (next 100M/month)$0.013source
Pay As You GoShort Code Inbound SMSmessage part (next 4.5M/month)$0.0045source
Pay As You GoShort Code Inbound SMSmessage part (next 20M/month)$0.0025source
Pay As You GoShort Code Inbound SMSmessage part (next 75M/month)$0.0015source
Pay As You GoShort Code Inbound MMSmessage part (next 75M/month)$0.008source
Pay As You GoShort Code Inbound SMSmessage part (next 100M/month)$0.001source
Pay As You GoShort Code Inbound MMSmessage part (next 100M/month)$0.007source
Pay As You GoAT&T Outbound SMS Carrier Fee (Short Code)message part$0.0035source
Pay As You GoAT&T Outbound MMS Carrier Fee (Short Code)message part$0.009source
Pay As You GoC Spire Wireless Outbound SMS Carrier Fee (Short Code)message part$0.0035source
Pay As You GoCarrier Group A Outbound SMS Carrier Fee (Short Code)message part$0.0035source
Pay As You GoCarrier Group A Outbound MMS Carrier Fee (Short Code)message part$0.005source
Pay As You GoT-Mobile USA Outbound SMS Carrier Fee (Short Code)message part$0.0045source
Pay As You GoT-Mobile USA Outbound MMS Carrier Fee (Short Code)message part$0.01source
Pay As You GoU.S. Cellular Outbound SMS Carrier Fee (Short Code)message part$0.0035source
Pay As You GoU.S. Cellular Outbound MMS Carrier Fee (Short Code)message part$0.01source
Pay As You GoVerizon Wireless Outbound SMS Carrier Fee (Short Code)message part$0.0045source
Pay As You GoVerizon Wireless Outbound MMS Carrier Fee (Short Code)message part$0.007source
Pay As You GoAT&T Inbound SMS Carrier Fee (Short Code)message part$0.0035source
Pay As You GoAT&T Inbound MMS Carrier Fee (Short Code)message part$0.009source
Pay As You GoC Spire Wireless Inbound SMS Carrier Fee (Short Code)message part$0source
Pay As You GoCarrier Group A Inbound SMS Carrier Fee (Short Code)message part$0.0035source
Pay As You GoCarrier Group A Inbound MMS Carrier Fee (Short Code)message part$0.005source
Pay As You GoCarrier Group B Inbound SMS Carrier Fee (Short Code)message part$0.0035source
Pay As You GoT-Mobile USA Inbound SMS Carrier Fee (Short Code)message part$0.0025source
Pay As You GoT-Mobile USA Inbound MMS Carrier Fee (Short Code)message part$0.01source
Pay As You GoC-Spire Outbound RCS Rich Textsegment$0.0065source
Pay As You GoC-Spire Inbound RCS Rich Textsegment$0.0065source
Pay As You GoGoogle Fi Outbound RCS Rich Textsegment$0.0065source
Pay As You GoGoogle Fi Inbound RCS Rich Textsegment$0.0065source
Pay As You GoSpectrum Outbound RCS Rich Textsegment$0.0065source
Pay As You GoSpectrum Inbound RCS Rich Textsegment$0.0065source
Pay As You GoT-Mobile USA Outbound RCS Rich Textsegment$0.0065source
Pay As You GoT-Mobile USA Inbound RCS Rich Textsegment$0.0065source
Pay As You GoVerizon Wireless Outbound RCS Rich Textsegment$0.0065source
Pay As You GoVerizon Wireless Inbound RCS Rich Textsegment$0.0065source
Pay As You GoC-Spire Outbound RCS Rich Mediamessage$0.016source
Pay As You GoC-Spire Inbound RCS Rich Mediamessage$0.016source
Pay As You GoGoogle Fi Outbound RCS Rich Mediamessage$0.016source
Pay As You GoGoogle Fi Inbound RCS Rich Mediamessage$0.016source
Pay As You GoSpectrum Outbound RCS Rich Mediamessage$0.016source
Pay As You GoSpectrum Inbound RCS Rich Mediamessage$0.016source
Pay As You GoT-Mobile USA Outbound RCS Rich Mediamessage$0.016source
Pay As You GoT-Mobile USA Inbound RCS Rich Mediamessage$0.016source
Pay As You GoVerizon Wireless Outbound RCS Rich Mediamessage$0.016source
Pay As You GoVerizon Wireless Inbound RCS Rich Mediamessage$0.016source
AT&T RCS Rich Origination Passthrough Feesegment$0.0045source
AT&T RCS Rich Termination Passthrough Feesegment$0.0045source
T-Mobile USA RCS Rich Origination Passthrough Feesegment$0.0025source
T-Mobile USA RCS Rich Termination Passthrough Feesegment$0.0062source
U.S. Cellular RCS Rich Origination Passthrough Feesegment$0.0025source
U.S. Cellular RCS Rich Termination Passthrough Feesegment$0.0062source
Verizon Wireless RCS Rich Termination Passthrough Feesegment$0.0045source
Other RCS Rich Origination Passthrough Feesegment$0source
Other RCS Rich Termination Passthrough Feesegment$0source
Verizon Wireless RCS Rich Origination Passthrough Feesegment$0source
AT&T RCS Rich Media Origination Passthrough Feemessage$0.01source
AT&T RCS Rich Media Termination Passthrough Feemessage$0.01source
T-Mobile USA RCS Rich Media Origination Passthrough Feemessage$0.013source
T-Mobile USA RCS Rich Media Termination Passthrough Feemessage$0.013source
U.S. Cellular RCS Rich Media Origination Passthrough Feemessage$0.013source
U.S. Cellular RCS Rich Media Termination Passthrough Feemessage$0.013source
Verizon Wireless RCS Rich Media Termination Passthrough Feemessage$0.007source
Other RCS Rich Media Origination Passthrough Feemessage$0source
Other RCS Rich Media Termination Passthrough Feemessage$0source
Verizon Wireless RCS Rich Media Origination Passthrough Feemessage$0source
T-Mobile USA Outbound RCS Rich Media Over 5MB SurchargeMB (over 5MB)$0.001source

Capabilities

Supported actions
send_message, retrieve_message, list_messages, receive_message, send_mms, send_rcs_message, group_messaging, list_messaging_profiles, create_messaging_profile, retrieve_messaging_profile, update_messaging_profile, delete_messaging_profile, regenerate_messaging_profile_secret, hosted_sms, automatic_opt_out_handling, message_queuing, alphanumeric_sender_id_messaging [8]
Regions
Global [9]
Input types
plain text, media URLs (images, videos, gifs via MMS), JSON request body [10]
Output types
JSON message records, webhook payloads (inbound messages, delivery receipts, message finalized events) [11]
Webhooks
Yes [12]
Sandbox / test mode
No [13]
SDK languages
Node.js, Python, PHP, Java, Ruby, Go [14]
MCP server
Yes [15]

Trust & compliance

SOC 2
SOC 2 Type II [16]
HIPAA
Yes [17]
GDPR
Yes [18]
ISO 27001
Yes [19]
PCI DSS
Yes [20]
Published SLA
Yes [21]
Rate limits
Account-level defaults: SMS 50 messages/second, MMS 15 messages/second, RCS 1 message/second. Per-sender: Long Code 0.1 MPS per number (non-US default), Toll-Free 20 MPS per number, Short Code 1,000 MPS per number, Alphanumeric Sender ID 0.1 MPS. Default Portal account limit: 1 message per second. US long code: 10 messages per minute per number. API request rate limits: dynamic, communicated via x-ratelimit-limit, x-ratelimit-remaining, and x-ratelimit-reset headers. [22]
Known restrictions
US long code numbers are restricted to sending 10 messages per minute for any single long code, Alphanumeric Sender IDs cannot receive messages (outbound only), Message Retrieval API can only retrieve messages that are no older than 10 days since their creation, By default, your Telnyx Portal account is limited to sending one message per second, Messages exceeding 160 characters (GSM-7) or 70 characters (UTF-16) are split and billed as multiple message parts, If a message remains in the queue for more than 4 hours, it is immediately rejected, Auto-response keywords (Cancel, End, Stop, Stopall, Stop all, Quit, Unsubscribe) automatically block the account/number from sending further SMS to the originating mobile number [23]

Developer surface

Docs rendering: static · markdown variants served · llms.txt present

Integration

API style
rest
Base URL
https://api.telnyx.com/v2
Version
v2
Versioning
url
Stability
ga
Auth methods
api_key
Idempotency keys
No
Error format
vendor-specific
Webhook signing
ed25519

SDKs

  • Node.js telnyx (npm) · repo
  • Python telnyx (pypi) · repo
  • PHP telnyx/telnyx-php (composer) · repo
  • Java com.telnyx.sdk:telnyx-java (Maven) · repo
  • Ruby telnyx (gem) · repo
  • Go github.com/team-telnyx/telnyx-go (Go module) · repo

Adoption & maturity

Launched
2009-01-01
GA
2024-05-09
Notable customers
Alibaba, Ooma, Neon Health, 42Chat, GoHappy, Beside, Helia, Reinvent Telecom, Ultradoc, Data Voice Options, Xpedeus, Lightspeed

Other SMS APIs

  • Twilio Programmable Messaging

    One Messaging API to reliably reach 7B+ devices

    Usage · public pricing · self-serve

  • Sinch SMS API

    "Simple, secure SMS API for global reach"

    Usage · public pricing · self-serve

  • Bird

    The global SMS API that scales with you

    Usage · public pricing · self-serve

  • Infobip SMS API

    Send business text messages with a leading SMS service provider

    Usage · public pricing · self-serve

  • Vonage SMS API

    Our SMS API helps you create customer journeys through conversations - even within the context of your app.

    Usage · public pricing · self-serve

  • AWS End User Messaging

    AWS End User Messaging empowers developers to integrate scalable and reliable messaging capabilities into their applications. AWS End User Messaging helps you engage your customers by sending them SMS, voice messages, WhatsApp, and push notifications.

    Usage · free tier · public pricing · self-serve

Telnyx SMS API alternatives · Telnyx SMS API vs Twilio Programmable Messaging · All SMS APIs APIs

References

Change history

Every field change, who made it, and when - from our audited data pipeline and editors.

  1. 2026-06-15 Score Docs Quality: 6080
  2. 2026-06-15 Score Agent Friendliness: 7080
  3. 2026-06-15 Llms Txt URL: https://telnyx.com/llms.txthttps://developers.telnyx.com/llms.txt
  4. 2026-06-15 API Reference URL: (none)https://developers.telnyx.com/api-reference/autorechargepreferences/list-auto-r…
  5. 2026-06-15 Robots Allows Agents: (none)No
  6. 2026-06-15 Has Structured Data: (none)Yes
  7. 2026-06-14 Score Docs Quality: 060
  8. 2026-06-14 Score Agent Friendliness: 3070
  9. 2026-06-14 Rendering: (none)static
  10. 2026-06-14 Llms Txt Present: (none)Yes
  11. 2026-06-14 Llms Txt URL: (none)https://telnyx.com/llms.txt
  12. 2026-06-14 Openapi Spec URL: (none)https://telnyx.com/openapi.json
  13. 2026-06-14 Status Page URL: (none)https://status.telnyx.com
  14. 2026-06-14 Markdown Docs Served: (none)Yes
  15. 2026-06-14 Markdown Docs URL: (none)https://telnyx.com/products/sms-api.md
  16. 2026-06-14 Docs URL: (none)https://developers.telnyx.com
  17. 2026-06-10 Last Verified At: 2026-06-06T00:00:00.000Z2026-06-10T00:00:00.000Z
  18. 2026-06-10 Score Pricing Transparency: (none)85
  19. 2026-06-10 Score Agent Friendliness: (none)30
  20. 2026-06-10 Best For: (none)AI agents and automation - an agent-ready surface (MCP / llms.txt), Teams needi…
  21. 2026-06-10 Avoid If: (none)You want to try it free before paying
  22. 2026-06-10 Scoring Methodology: (none)Scores are computed deterministically from this profile's published, sourced fi…
  23. 2026-06-10 Score Docs Quality: (none)0
  24. 2026-06-10 Score Procurement Friction: (none)85
  25. 2026-06-10 Score Setup Speed: (none)60
  26. 2026-06-10 Score Trust Readiness: (none)100
  27. 2026-06-10 Starting Price Usd: 0.0040.004
  28. 2026-06-10 SDK Packages: Node.js, Python, PHP, Java, Ruby, GoNode.js, Python, PHP, Java, Ruby, Go
  29. 2026-06-10 Documented Rate Limits: set to Account-level defaults: SMS 50 messages/second, MMS 15 messages/second, RCS 1 m…
  30. 2026-06-10 Known Restrictions: set to US long code numbers are restricted to sending 10 messages per minute for any s…
  31. 2026-06-10 Auth Methods: set to api_key
  32. 2026-06-10 Auth Docs URL: set to https://developers.telnyx.com/development/api-fundamentals/authentication
  33. 2026-06-10 API Style: set to rest
  34. 2026-06-10 Base URL: set to https://api.telnyx.com/v2
  35. 2026-06-10 API Version: set to v2
  36. 2026-06-10 Versioning Scheme: set to url
  37. 2026-06-10 Stability: set to ga
  38. 2026-06-10 MCP URL: set to https://github.com/team-telnyx/telnyx-mcp-server
  39. 2026-06-10 Quickstart URL: set to https://developers.telnyx.com/docs/messaging/messages/send-message
  40. 2026-06-10 Idempotency Supported: set to No
  41. 2026-06-10 Error Format: set to vendor-specific
  42. 2026-06-10 Webhook Signing: set to ed25519
  43. 2026-06-10 Webhook Events URL: set to https://developers.telnyx.com/docs/messaging/messages/receiving-webhooks
  44. 2026-06-10 Requires Verification: set to Yes
  45. 2026-06-10 Starting Price Usd: set to 0.004
  46. 2026-06-10 Price Basis: set to message
  47. 2026-06-10 Free Tier Limit: set to $5 testing credit (trial)
  48. 2026-06-10 Launched At: set to 2009-01-01
  49. 2026-06-10 GA Date: set to 2024-05-09
  50. 2026-06-10 Notable Customers: set to Alibaba, Ooma, Neon Health, 42Chat, GoHappy, Beside, Helia, Reinvent Telecom, U…

Suggest an edit / leave a review

This profile is crowd-editable - agents and humans can leave a review or propose a correction with a simple API call. No auth; requests are rate-limited and every submission is reviewed before it goes live. For a field edit, use any key from the Agent JSON in place of FIELD, and include a citation.

Leave a review or comment

curl -X POST https://apio.sh/api/feedback/telnyx-sms \
  -H 'Content-Type: application/json' \
  -d '{"kind":"review","rating":5,"body":"Your experience with this API…"}'

Suggest a correction to a field (cite a source)

curl -X POST https://apio.sh/api/suggest/telnyx-sms/FIELD \
  -H 'Content-Type: application/json' \
  -d '{"value":"corrected value","citations":[{"url":"https://source.example/page","excerpt":"supporting quote"}],"note":"what changed and why"}'

All the ways to contribute →