TXTMSG.lk Python SDK — Python SMS Gateway Integration for Sri Lanka

Official Python SDK for TXTMSG.lk SMS Gateway API v3. Send bulk SMS, transactional SMS, campaigns, and manage contacts from any Python 3.9+ application. The reliable Python SMS client for Sri Lanka's leading SMS gateway.

Features

• Send SMS — Deliver single or bulk messages to any country via REST API
• Campaign Management — Send SMS campaigns using contact lists
• Contact Groups — Create, update, and manage contact groups
• Contacts — Import and manage individual contacts within groups
• Schedule Messages — Set future delivery times for your SMS
• Balance & Profile — Check remaining SMS units and account details
• DLT Support — Send DLT-compliant messages with template IDs
• httpx — Modern HTTP client with sync and async support
• Type Hints — Full type annotations for IDE autocompletion

Requirements

• Python 3.9+

Installation

pip install txtmsg-sdk

Quick Start

Send an SMS

from txtmsg import TxtmsgClient

client = TxtmsgClient(api_key="your-api-key-here")

response = client.send_sms(
    recipient="94771234567",
    sender_id="TXTMSG",
    message="Hello from TXTMSG.lk!",
)

print(response)

Check Balance

balance = client.view_balance()
print(balance["data"]["remaining_balance"])

Send a Campaign

client.send_campaign(
    contact_list_id="6415907d0d37a",
    sender_id="TXTMSG",
    message="Campaign message",
    schedule_time="2025-12-20 07:00",
)

API Reference

Client

TxtmsgClient(api_key: str, base_url: str | None = None, http_client: httpx.Client | None = None)

SMS Operations

Contact Groups

Contacts

Account

Error Handling

from txtmsg import TxtmsgClient, TxtmsgError

client = TxtmsgClient(api_key="your-key")

try:
    client.send_sms(recipient="94771234567", sender_id="TXTMSG", message="Hello")
except TxtmsgError as e:
    print(f"API Error [{e.status_code}]: {e}")

About TXTMSG.lk

TXTMSG.lk is a Sri Lankan SMS gateway provider offering reliable bulk SMS services, transactional SMS APIs, and messaging solutions for businesses. The API v3 provides RESTful endpoints for SMS delivery, contact management, and campaign automation with worldwide coverage.

Documentation

• API Documentation
• Postman Collection

Support

• Email: support@txtmsg.lk
• Phone: +94 773 59 304 / +94 716 170 000

License

MIT