Unofficial Python SDK for the Tally.so API.
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.
- Users
- Organizations
- Forms
- Workspaces
- Webhooks
- MCP
pip install pytally-sdkuv add pytally-sdkRequirements:
Python ≥ 3.11
httpx (auto-installed)
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})")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})")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}")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.
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.")👉 Full documentation and API reference available at: https://pytally-sdk.fa.dev.br
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 hooksLicensed 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.