Skip to main content

Getting Started with Agile Telecom SMS

Welcome to the Agile Telecom SMS documentation. Send SMS messages to mobile subscribers worldwide through a robust REST API or a high-throughput SMPP binary connection — with delivery reports, two-way messaging and full network intelligence.

What You Can Do​

  • Outbound SMS — Send transactional and marketing SMS over REST or SMPP, including concatenated and Unicode messages.
  • Inbound SMS — Receive SMS on a rented number via email or webhook, with +OK ack semantics.
  • Delivery Reports (DLR) — Track real-time delivery status of every message you send.
  • Network Intelligence — Validate numbers via MNP lookup and check available credit before sending.
  • Scheduling and Bulk Sending — Send to thousands of destinations in a single API call.

Base URL​

REST API endpoint:

https://wholesale.agiletelecom.com/services/

SMPP endpoint:

smpp.agiletelecom.com:2776 (TLS)

Authentication​

Two authentication methods are supported. API Key is recommended for new integrations.

  • API Key — Send X-Api-Key: YOUR_API_KEY in every HTTPS request.
  • Basic Auth — Send Authorization: Basic <base64(user:pass)>.

Both methods support optional IP whitelisting as an additional security layer.

See the Authentication guide for examples.

Essential Concepts​

Sender ID — The "from" identifier shown on the recipient phone. Can be a numeric short code or an alphanumeric string (max 11 characters, country-dependent).

Message body — Up to 160 GSM-7 characters per part, or 70 UCS-2 characters for Unicode (emoji, non-Latin alphabets). Longer messages are automatically split into concatenated parts.

Delivery report (DLR) — Asynchronous notification of the final delivery status (DELIVERED, FAILED, EXPIRED…), pushed to your webhook in real time.

Inbound SMS — Messages received on a number you rent from Agile Telecom, forwarded to your webhook or email.

Credit and MNP — Real-time checks for account balance and number portability so you can avoid wasted sends.

Next Steps​

  1. Quick Start — Send your first SMS in 3 minutes.
  2. Authentication — Secure your requests.
  3. Sending SMS — Encoding, sender IDs, scheduling and bulk sends.
  4. Delivery Reports — Track real-time delivery.
  5. Best Practices — Throughput, opt-out, retries.

Ready to integrate? Open the full SMS API on the wholesale portal.