zindua-sdk 1.0.0

Official Zindua SDK for Python — transactional email and WhatsApp via POST /api/v1/send.

zindua-sdk

Official server-side Python SDK for Zindua: send transactional email and WhatsApp messages.

FastAPI guide	zindua.run/fastapi
Full API reference	zindua.run/developers
Dashboard	zindua.run/login

pip install zindua-sdk

Requirements: Python 3.10+, run only on your backend (never ship ZINDUA_API_KEY to browsers).

Quick start

import asyncio
from zindua import Zindua

async def main():
    client = Zindua(api_key="znd_test_xxxxxxxxxxxxxxxxxxxxxxxx")
    result = await client.send(
        to="[e-mail]",
        template="otp-verification",
        lang="fr",
        variables={"code": "482910", "appName": "MyApp"},
    )
    print(result.log_id, result.status)

asyncio.run(main())

FastAPI

from zindua.integrations.fastapi import get_zindua

@app.post("/send-otp")
async def send_otp(body: SendOtpRequest, zindua: Zindua = Depends(get_zindua)):
    return await zindua.send(to=body.to, template="otp-verification", variables={"code": body.code})

CLI

export ZINDUA_API_KEY=znd_test_...
python -m zindua doctor
python -m zindua send --to [e-mail] --template otp-verification --var code=482910

Publish (maintainers)

cd packages/zindua-python
python -m pip install build twine
python -m build
twine upload dist/*

Bump version in pyproject.toml and PYTHON_SDK_VERSION in the app before each release.

License

MIT © Zindua