At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
TALLY_API_KEYis sent as theBearerprefixedAuthorizationheader. - Docs: https://developers.tally.so/api-reference/api-keys
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
TALLY_API_KEY | Yes | Tally API key (created in Tally under Settings > API keys; shown only once) Docs. |
Setup
- Create an API key: Sign in to Tally (free accounts work - the API is available to all users), go to Settings > API keys, and click ‘Create API key’. Copy the key immediately; it is shown only once.
- Set the environment variable: Add TALLY_API_KEY to your .env.
- Verify access: Run List Forms. The key is sent as Authorization: Bearer <key> against https://api.tally.so.
- For real-time submission data, Tally recommends webhooks over polling the submissions endpoint.
- List endpoints are paginated with page/limit and return hasMore plus total counts.
Tools
| Tool | Access | Description |
|---|---|---|
| List Forms | Read | List forms in the Tally account, optionally filtered by workspace |
| Get Form | Read | Retrieve a single form by ID with all its blocks and settings |
| List Submissions | Read | List submissions of a form with their responses, filterable by status and date range |
| Get Submission | Read | Retrieve a specific form submission with all its responses and the form questions |
| List Form Questions | Read | List a form’s questions with their IDs, types, and response counts - lighter than parsing the full form blocks for mapping answers |
| List Workspaces | Read | List workspaces with their members and pending invites |
Example prompts
- List my Tally forms, pick the most recently updated one, and summarize its latest submissions.
- Give me an overview of my Tally forms with their status and number of submissions.
- For a given Tally form, compare completed vs partial submissions and report the completion rate.