PyTally SDK

Unofficial Python SDK for the Tally.so API.

Overview

PyTally SDK is a lightweight, fully typed Python client for the Tally.so API. It provides a clean, Pythonic interface for authenticating, querying, and managing Tally resources -- without worrying about HTTP requests or pagination.

Implemented Resources

• Users
• Organizations
• Forms
• Workspaces
• Webhooks
• MCP

Installation

pip

pip install pytally-sdk

uv (recommended)

uv add pytally-sdk

Requirements: Python ≥ 3.11 httpx (auto-installed)

Quick Start

from tally import Tally

client = Tally(api_key="tly_your_api_key_here")

user = client.users.me()
print(f"Hello, {user.full_name} ({user.email})")

With Context Manager

from tally import Tally

with Tally(api_key="tly_your_api_key_here") as client:
    for form in client.forms:
        print(f"{form.name} ({form.id})")

Webhooks — Example Usage

List Webhooks

from tally import Tally

client = Tally(api_key="tly_your_api_key_here")

# Get all webhooks
for webhook in client.webhooks:
    print(f"{webhook.url} → enabled={webhook.is_enabled}")

Create a Webhook

from tally import Tally

client = Tally(api_key="tly_your_api_key_here")

webhook = client.webhooks.create(
    url="https://your-app.com/webhooks/tally",
    event_types=["FORM_RESPONSE"],
)

print(f"Webhook created: {webhook.id}")

For complete API usage, visit the 📘 Webhooks Reference.

Error Handling

from tally import Tally, UnauthorizedError, NotFoundError

client = Tally(api_key="tly_invalid")

try:
    client.users.me()
except UnauthorizedError:
    print("Invalid API key.")
except NotFoundError:
    print("Resource not found.")

See Error Handling → docs.

Documentation

👉 Full documentation and API reference available at: https://pytally-sdk.fa.dev.br

Development

Wanna help improve the SDK?

git clone https://github.com/felipeadeildo/pytally.git
cd pytally
uv sync
uv run mkdocs serve  # preview docs locally
pre-commit install   # install pre-commit hooks

🔗 Links

• 📦 PyPI Package
• 💻 GitHub Repository
• 🧾 Tally API Reference
• 🪲 Issue Tracker
• 📘 Documentation

⚖️ License

Licensed under the Apache License 2.0.

Disclaimer This is an unofficial SDK and is not affiliated with or endorsed by Tally. “Tally” and the Tally logo are trademarks of Tally B.V.