Skip to main content
Tally logo
  • Category: forms & surveys
  • Auth: API_KEY, OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 18
  • Triggers: 0
  • Slug: TALLY
  • Version: 20261101_00

Tools

Slug: TALLY_CREATE_FORMTool to create a new form. Use after preparing block definitions and optional settings.

Input Parameters

string
Title of the form.
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.
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.
object
Optional form appearance and behavior settings.
string
Template ID to base the form on.
string
Workspace ID to create the form under. The API expects ‘workspace_id’ (snake_case), not ‘workspaceId’ (camelCase).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_CREATE_WEBHOOKTool to create a new webhook for a form. Use after confirming you have the form ID and the callback URL.

Input Parameters

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.
string
required
ID of the form to associate with the webhook.
array
List of event types that trigger the webhook. Currently only ‘FORM_RESPONSE’ is supported.
array
Optional list of custom HTTP headers to send with each webhook call.
string
Optional secret used to sign payloads for verification.
string
Optional external identifier for the subscriber.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_DELETE_FORMDelete a specific form by ID, moving it to the trash.

Input Parameters

string
required
The unique identifier of the form to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_DELETE_WEBHOOKDelete a specific webhook by ID. If it is the last webhook for its form, the webhooks integration is also marked as deleted.

Input Parameters

string
required
Unique identifier of the webhook to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_GET_FORM_DETAILSRetrieve a form by ID, including its blocks, submission count, metadata, and supported settings.

Input Parameters

string
required
The unique identifier of the form to retrieve details for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_GET_FORM_RESPONSESRetrieve a page of submissions and responses for a specific form. The accepted limit is not used to control the page size.

Input Parameters

integer
Page number for pagination (>=1).
integer
Number of submissions per page (>=1).
string
required
The unique identifier of the form to retrieve responses for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_GET_USER_INFORetrieve account information for the authenticated user, including their organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_GET_WEBHOOK_EVENTSTool to list events associated with a specific webhook. Use when you need to inspect delivery history after creating or listing a webhook.

Input Parameters

integer
Page number for pagination, must be >= 1
string
required
Unique identifier of the webhook to list events for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_GET_WORKSPACETool 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

string
required
The unique identifier of the workspace to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_LIST_FORM_QUESTIONSTool 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

string
required
The unique identifier of the form to retrieve questions for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_LIST_FORMSTool to retrieve a paginated list of forms. Use when you need to list all forms accessible to the authenticated user.

Input Parameters

integer
Page number for pagination (>=1). Increment to iterate through all pages when total forms exceed one page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_LIST_ORGANIZATION_INVITESTool to retrieve all pending invites in your organization. Use when you need to view or manage organization invitation status.

Input Parameters

string
required
The ID of the organization to retrieve invites for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_LIST_ORGANIZATION_USERSRetrieve users in an organization by organization ID.

Input Parameters

string
required
The ID of the organization to retrieve users from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_LIST_WEBHOOKSTool 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

integer
Page number for pagination (>=1).
integer
Number of webhooks per page (1-100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_LIST_WORKSPACESTool to retrieve a paginated list of workspaces. Use when you need to browse workspaces accessible to the authenticated user.

Input Parameters

integer
Page number for pagination (>=1).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_UPDATE_FORMTool to update form details. Use after confirming the form exists and obtaining its ID.

Input Parameters

string
New name for the form.
array
Updated ordered list of blocks defining the form content.
string
required
The unique identifier of the form to update.
string ("BLANK" | "PUBLISHED")
New status of the form.
object
Optional appearance and behavior settings for a form.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_UPDATE_WEBHOOKUpdate 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

string
required
Callback endpoint URL for webhook notifications.
string
required
ID of the form to associate with the webhook.
boolean
required
Whether the webhook should be enabled or disabled.
string
required
Unique identifier of the webhook to update.
array
required
List of event types that trigger the webhook. Currently only ‘FORM_RESPONSE’ is supported.
array
Optional list of custom HTTP headers to send with each webhook call.
string
Optional secret used to sign payloads for verification.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TALLY_UPDATE_WORKSPACETool 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

string
The new name for the workspace.
string
required
The unique identifier of the workspace to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not