Skip to main content

Agile Telecom SMS Documentation

Send SMS at scale to mobile subscribers worldwide through a robust REST API or a high-throughput SMPP connection — with real-time delivery reports, inbound messaging and network intelligence.

Ready to start?

Open the Quick Start and send your first SMS in under 3 minutes.

How it works​

  1. Authenticate — Get your API key from the wholesale portal and send it in the X-Api-Key header (or use Basic Auth).
  2. Send — POST a JSON payload to the SMS endpoint with destination(s), sender and body.
  3. Track — Receive delivery reports on your webhook in real time.

Getting started​

GuideDescription
IntroductionPlatform overview, endpoints, and key concepts
Quick StartSend your first SMS in 3 minutes
AuthenticationAPI Key, Basic Auth, and IP whitelist

Guides​

GuideDescription
Sending SMSEncoding, sender IDs, concatenation, scheduling and bulk sends
Delivery ReportsWebhook payload and status codes
Inbound SMSReceive SMS via webhook or email on a rented number
Best PracticesThroughput, opt-out, retries and observability
Error HandlingHTTP and DLR status codes with recovery patterns

API Reference​

Every endpoint includes code examples in cURL, Python, Node.js, PHP, Java, C#, Go, and Ruby.

Messaging​

APIDescription
SMS REST APISend SMS over HTTPS with concatenation, Unicode and scheduling
SMPP ProtocolBinary protocol over TLS for high-throughput delivery
Inbound SMSReceive SMS via email or HTTP webhook

Network services​

APIDescription
Credit CheckQuery account balance in real time
MNP LookupCarrier, porting status and network details for a mobile number

Developer tools​

ResourceDescription
AI IntegrationUse these docs with ChatGPT, Claude, Copilot or Cursor
llms.txtMachine-readable API overview
llms-full.txtComplete docs in a single file
FAQCommon questions about authentication, sending and delivery
SMS API on the wholesale portalFull request/response reference and live console

Authentication​

All APIs authenticate over HTTPS using one of the following methods. See the Authentication guide for details.

MethodHeaderUsed by
API KeyX-Api-Key: your-keyAll APIs (recommended)
Basic AuthAuthorization: Basic base64(user:pass)All APIs

Optional IP whitelisting can be enabled per account for additional security.

Need help?​