iMessage Python SDK

Install

One command to add the iMessage Python SDK to your project.

pip install blooio
# or with uv
uv pip install blooio

Send your first iMessage

This is the smallest working example — authenticate with your Blooio API key, then call the send-message method on the client.

from blooio import Blooio

blooio = Blooio(api_key="blooio_live_...")

blooio.chats.send_message(
    phone="+15551234567",
    body="Hey Alex — thanks for booking a demo. Reply with any questions.",
)

Handle inbound iMessages and webhooks

Every inbound iMessage, delivery, read, and reaction event is POSTed to your webhook URL. Use the SDK's signature verifier to reject forged requests and deserialize the payload into typed objects.

from fastapi import FastAPI, Request, HTTPException
from blooio import verify_webhook, InvalidSignature

app = FastAPI()

@app.post("/webhooks/blooio")
async def blooio_webhook(request: Request):
    body = await request.body()
    signature = request.headers.get("x-blooio-signature", "")

    try:
        event = verify_webhook(
            body=body,
            signature=signature,
            secret="whsec_...",
        )
    except InvalidSignature:
        raise HTTPException(status_code=401, detail="bad signature")

    if event.type == "message.received":
        print("Inbound iMessage:", event.data.body)

    return {"ok": True}

What the SDK gives you on top of raw REST

• Sync (requests) and async (httpx) clients that share a typed interface
• pydantic models for every endpoint and webhook payload
• Automatic retries with exponential backoff on 429 and 5xx responses
• Drop-in webhook verifiers for Flask, FastAPI, and Django
• Batched send helpers for bulk campaigns with rate-limit awareness
• Python 3.9+ supported — works in Lambda, Cloud Run, and containers

Python iMessage SDK FAQ