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?