> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tally

> Tally is a form-building platform that allows users to create forms, collect responses, and integrate with various tools and services.

![Tally logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/tally.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=063cadeeef94b564bd1accfa0d7d44a4)

* **Category:** forms & surveys
* **Auth:** API\_KEY, OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 18
* **Triggers:** 0
* **Slug:** `TALLY`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Form
>
> **Slug:** `TALLY_CREATE_FORM`
>
> Tool to create a new form. Use after preparing block definitions and optional settings.
>
> #### Input Parameters
>
> **title** `string`
>
> Title of the form.
>
> **blocks** `array` *required*
>
> Ordered list of blocks that make up the form (content blocks, question blocks, and child/option blocks). Each block object includes: uuid, type, groupUuid, groupType, payload.
>
> **status** `string ("BLANK" | "PUBLISHED")` *required*
>
> Form status: BLANK or PUBLISHED. This field is required by the API. BLANK forms are inaccessible to users; use PUBLISHED for public access.
>
> **settings** `object`
>
> Optional form appearance and behavior settings.
>
> **templateId** `string`
>
> Template ID to base the form on.
>
> **workspaceId** `string`
>
> Workspace ID to create the form under. The API expects 'workspace\_id' (snake\_case), not 'workspaceId' (camelCase).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook
>
> **Slug:** `TALLY_CREATE_WEBHOOK`
>
> Tool to create a new webhook for a form. Use after confirming you have the form ID and the callback URL.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Callback endpoint URL for webhook notifications. Must be a publicly reachable HTTPS endpoint. FORM\_RESPONSE events may be retried, so the handler should process payloads idempotently.
>
> **formId** `string` *required*
>
> ID of the form to associate with the webhook.
>
> **eventTypes** `array`
>
> List of event types that trigger the webhook. Currently only 'FORM\_RESPONSE' is supported.
>
> **httpHeaders** `array`
>
> Optional list of custom HTTP headers to send with each webhook call.
>
> **signingSecret** `string`
>
> Optional secret used to sign payloads for verification.
>
> **externalSubscriber** `string`
>
> Optional external identifier for the subscriber.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Form
>
> **Slug:** `TALLY_DELETE_FORM`
>
> Delete a specific form by ID, moving it to the trash.
>
> #### Input Parameters
>
> **formId** `string` *required*
>
> The unique identifier of the form to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook
>
> **Slug:** `TALLY_DELETE_WEBHOOK`
>
> Delete a specific webhook by ID. If it is the last webhook for its form, the webhooks integration is also marked as deleted.
>
> #### Input Parameters
>
> **webhookId** `string` *required*
>
> Unique identifier of the webhook to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Form Details
>
> **Slug:** `TALLY_GET_FORM_DETAILS`
>
> Retrieve a form by ID, including its blocks, submission count, metadata, and supported settings.
>
> #### Input Parameters
>
> **formId** `string` *required*
>
> The unique identifier of the form to retrieve details for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Form Responses
>
> **Slug:** `TALLY_GET_FORM_RESPONSES`
>
> Retrieve a page of submissions and responses for a specific form. The accepted limit is not used to control the page size.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (>=1).
>
> **limit** `integer`
>
> Number of submissions per page (>=1).
>
> **formId** `string` *required*
>
> The unique identifier of the form to retrieve responses for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Info
>
> **Slug:** `TALLY_GET_USER_INFO`
>
> Retrieve account information for the authenticated user, including their organization ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhook Events
>
> **Slug:** `TALLY_GET_WEBHOOK_EVENTS`
>
> Tool to list events associated with a specific webhook. Use when you need to inspect delivery history after creating or listing a webhook.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **webhookId** `string` *required*
>
> Unique identifier of the webhook to list events for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace
>
> **Slug:** `TALLY_GET_WORKSPACE`
>
> Tool to retrieve a single workspace by its ID with associated members. Use when you need to get detailed information about a specific workspace.
>
> #### Input Parameters
>
> **workspaceId** `string` *required*
>
> The unique identifier of the workspace to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Form Questions
>
> **Slug:** `TALLY_LIST_FORM_QUESTIONS`
>
> Tool to retrieve all questions from a specific form. Use when you need to list all questions and their structure after obtaining the form ID.
>
> #### Input Parameters
>
> **formId** `string` *required*
>
> The unique identifier of the form to retrieve questions for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Forms
>
> **Slug:** `TALLY_LIST_FORMS`
>
> Tool to retrieve a paginated list of forms. Use when you need to list all forms accessible to the authenticated user.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (>=1). Increment to iterate through all pages when total forms exceed one page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Invites
>
> **Slug:** `TALLY_LIST_ORGANIZATION_INVITES`
>
> Tool to retrieve all pending invites in your organization. Use when you need to view or manage organization invitation status.
>
> #### Input Parameters
>
> **organizationId** `string` *required*
>
> The ID of the organization to retrieve invites for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Users
>
> **Slug:** `TALLY_LIST_ORGANIZATION_USERS`
>
> Retrieve users in an organization by organization ID.
>
> #### Input Parameters
>
> **organizationId** `string` *required*
>
> The ID of the organization to retrieve users from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `TALLY_LIST_WEBHOOKS`
>
> Tool to retrieve a paginated list of configured webhooks. Use when you need a full listing of webhooks across your accessible forms and workspaces.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (>=1).
>
> **limit** `integer`
>
> Number of webhooks per page (1-100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workspaces
>
> **Slug:** `TALLY_LIST_WORKSPACES`
>
> Tool to retrieve a paginated list of workspaces. Use when you need to browse workspaces accessible to the authenticated user.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (>=1).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Form
>
> **Slug:** `TALLY_UPDATE_FORM`
>
> Tool to update form details. Use after confirming the form exists and obtaining its ID.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the form.
>
> **blocks** `array`
>
> Updated ordered list of blocks defining the form content.
>
> **formId** `string` *required*
>
> The unique identifier of the form to update.
>
> **status** `string ("BLANK" | "PUBLISHED")`
>
> New status of the form.
>
> **settings** `object`
>
> Optional appearance and behavior settings for a form.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Webhook
>
> **Slug:** `TALLY_UPDATE_WEBHOOK`
>
> Update an existing webhook configuration, including its URL, event types and enabled status. The form ID, URL, event types and enabled status must all be supplied.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Callback endpoint URL for webhook notifications.
>
> **formId** `string` *required*
>
> ID of the form to associate with the webhook.
>
> **isEnabled** `boolean` *required*
>
> Whether the webhook should be enabled or disabled.
>
> **webhookId** `string` *required*
>
> Unique identifier of the webhook to update.
>
> **eventTypes** `array` *required*
>
> List of event types that trigger the webhook. Currently only 'FORM\_RESPONSE' is supported.
>
> **httpHeaders** `array`
>
> Optional list of custom HTTP headers to send with each webhook call.
>
> **signingSecret** `string`
>
> Optional secret used to sign payloads for verification.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Workspace
>
> **Slug:** `TALLY_UPDATE_WORKSPACE`
>
> Tool to update the details of a specific workspace identified by its ID. Use when you need to rename a workspace after confirming the workspace ID.
>
> #### Input Parameters
>
> **name** `string`
>
> The new name for the workspace.
>
> **workspaceId** `string` *required*
>
> The unique identifier of the workspace to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
