unlimited-messaging 0.1.0

Python SDK for the Unlimited Messaging API

unlimited-messaging

Official Python client for the Unlimited Messaging API — send and receive WhatsApp messages programmatically.

• Website: unlimitedmessaging.app
• Docs: docs.unlimitedmessaging.app
• API reference: api.unlimitedmessaging.app
• GitHub: unlimitedmessaging/unlimited-messaging-sdk

Installation

pip install unlimited-messaging

Quick start

import os
from unlimited_messaging import UnlimitedMessagingApi

client = UnlimitedMessagingApi(
    token=os.environ["API_TOKEN"],
)

# Send a WhatsApp message
message = client.message.message_controller_send(
    recipient="[phone]",
    text="Hello!",
)

print(message.id, message.status)

Authentication

Get your API token from the dashboard and pass it as the token argument.

client = UnlimitedMessagingApi(token="your_api_token")

Examples

Send a message

message = client.message.message_controller_send(
    recipient="[phone]",
    text="Hello from the SDK!",
    sim_id="optional-sim-id",  # force a specific SIM
)

List messages

result = client.message.message_controller_find_all(
    page=1,
    limit=20,
    status="DELIVERED",   # PENDING | SENDING | SENT | DELIVERED | READ | FAILED
    search="keyword",
)

print(f"{result.total} messages")
for msg in result.data:
    print(msg.id, msg.status, msg.text)

List linked SIMs

sims = client.sim.sim_controller_get_linked_sims()

for sim in sims:
    print(sim.id, sim.phone_number)

Async support

import asyncio
from unlimited_messaging import AsyncUnlimitedMessagingApi

client = AsyncUnlimitedMessagingApi(token="your_api_token")

async def main():
    message = await client.message.message_controller_send(
        recipient="[phone]",
        text="Hello async!",
    )
    print(message.id, message.status)

asyncio.run(main())

API reference

Method	Description
message.message_controller_send	Send a WhatsApp message
message.message_controller_find_all	List messages with pagination and filters
sim.sim_controller_get_linked_sims	List linked SIMs

Full OpenAPI spec: openapi.yaml