Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Tally

Receive form submissions from Tally forms

CategoryForms And Surveys
Authenticationcustom
Version0.6.0
Published scopes0 published scopes
Last updatedSeptember 24, 2026

Overview

Connect Tally with Flows360

Receive form submissions from Tally forms

Use the Tally connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 25 actions and 1 trigger.

Available actions

  • List Forms
  • Create Form
  • Get Form
  • Update Form
  • Delete Form
  • List Form Questions
  • List Submissions
  • Get Submission
  • Plus 17 additional declared actions.

Available triggers

  • New Submission

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Tally
  • Package: @activepieces/piece-tally@0.6.0
  • Exact artifact digest: sha256:f288121a02574f49cd443846dbaf4a5202e37b9455e97aa949848aad4e65943d
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • List Forms (list_forms), List all forms in your Tally account Classification: read.
  • Create Form (create_form), Create a new form from a blocks definition Classification: read.
  • Get Form (get_form), Get a single form by id, including its blocks and settings Classification: read.
  • Update Form (update_form), Update a form's name, status, blocks, or settings Classification: read.
  • Delete Form (delete_form), Permanently delete a form Classification: read.
  • List Form Questions (list_form_questions), List the questions on a form, with their ids and titles Classification: read.
  • List Submissions (list_submissions), List a form's submissions, with filters for status and date range Classification: read.
  • Get Submission (get_submission), Get a single submission by id Classification: read.
  • Delete Submission (delete_submission), Permanently delete a single submission Classification: read.
  • Get Form Metrics (get_form_metrics), Get summary metrics for a form over a time period Classification: read.
  • Get Form Visit Analytics (get_form_visit_analytics), Get visit counts over time for a form Classification: read.
  • Get Form Submission Analytics (get_form_submission_analytics), Get completed vs partial submission counts over time for a form Classification: read.
  • Get Form Analytics Dimensions (get_form_analytics_dimensions), Get visitor breakdowns by source, browser, OS, device, and location for a form Classification: read.
  • Get Form Drop-off Analytics (get_form_drop_off_analytics), Get per-question drop-off rates for a form Classification: read.
  • List Workspaces (list_workspaces), List all workspaces in your Tally account Classification: read.
  • Create Workspace (create_workspace), Create a new workspace Classification: read.
  • Get Workspace (get_workspace), Get a single workspace by id Classification: read.
  • Rename Workspace (rename_workspace), Rename a workspace Classification: read.
  • Delete Workspace (delete_workspace), Permanently delete a workspace and everything inside it Classification: read.
  • List Workspace Folders (list_workspace_folders), List folders inside a workspace Classification: read.
  • Create Folder (create_folder), Create a folder inside a workspace Classification: read.
  • Rename Folder (rename_folder), Rename a folder Classification: read.
  • Delete Folder (delete_folder), Delete a folder and its subtree, moving contained forms to trash Classification: read.
  • Get Current User (get_current_user), Get the connected account's profile and subscription plan Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • New Submission, webhook.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authenticationcustom
Supported objects26
Supported actions25
Triggers1

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • API Key Required · protected credential

Supported objects

ObjectReadWriteNotes
List Forms Yes No List all forms in your Tally account
Create Form Yes No Create a new form from a blocks definition
Get Form Yes No Get a single form by id, including its blocks and settings
Update Form Yes No Update a form's name, status, blocks, or settings
Delete Form Yes No Permanently delete a form
List Form Questions Yes No List the questions on a form, with their ids and titles
List Submissions Yes No List a form's submissions, with filters for status and date range
Get Submission Yes No Get a single submission by id
Delete Submission Yes No Permanently delete a single submission
Get Form Metrics Yes No Get summary metrics for a form over a time period
Get Form Visit Analytics Yes No Get visit counts over time for a form
Get Form Submission Analytics Yes No Get completed vs partial submission counts over time for a form
Get Form Analytics Dimensions Yes No Get visitor breakdowns by source, browser, OS, device, and location for a form
Get Form Drop-off Analytics Yes No Get per-question drop-off rates for a form
List Workspaces Yes No List all workspaces in your Tally account
Create Workspace Yes No Create a new workspace
Get Workspace Yes No Get a single workspace by id
Rename Workspace Yes No Rename a workspace
Delete Workspace Yes No Permanently delete a workspace and everything inside it
List Workspace Folders Yes No List folders inside a workspace
Create Folder Yes No Create a folder inside a workspace
Rename Folder Yes No Rename a folder
Delete Folder Yes No Delete a folder and its subtree, moving contained forms to trash
Get Current User Yes No Get the connected account's profile and subscription plan
Custom API Call Yes No Make a custom API call to a specific endpoint
New Submission Yes No webhook trigger declared by the pinned package.

Supported actions

List Forms · Read

List all forms in your Tally account

list_forms · Risk: low · Retry: safe

Inputs

  • page · number · Optional, Page number, starting at 1. Defaults to 1.
  • limit · number · Optional, Number of forms per page (max 500). Defaults to 50.
Create Form · Read

Create a new form from a blocks definition

create_form · Risk: low · Retry: safe

Inputs

  • blocks · object · Required, Array of Tally block objects that define the form content and fields (titles, inputs, choices, etc). Fetch an existing form with Get Form to see the exact shape blocks must take.
  • status · string · Required, BLANK has no content yet; DRAFT is editable and not publicly accessible; PUBLISHED is live and accepting submissions.
  • workspace_id · string · Optional, Defaults to your account's default workspace if left empty.
  • folder_id · string · Optional, Only folders inside the selected workspace are shown.
  • template_id · string · Optional, Optional Tally template ID to base the form on.
  • settings · object · Optional, Optional form settings object (language, notifications, redirects, data retention, styling, password protection, etc).
Get Form · Read

Get a single form by id, including its blocks and settings

get_form · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
Update Form · Read

Update a form's name, status, blocks, or settings

update_form · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • name · string · Optional
  • status · string · Optional
  • blocks · object · Optional, Replaces the entire blocks array. Use Get Form first to fetch the current blocks so you can merge your change into the full array rather than dropping the rest of the form content.
  • settings · object · Optional, Replaces the entire settings object. Use Get Form first if you need to preserve other settings.
Delete Form · Read

Permanently delete a form

delete_form · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
List Form Questions · Read

List the questions on a form, with their ids and titles

list_form_questions · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
List Submissions · Read

List a form's submissions, with filters for status and date range

list_submissions · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • filter · string · Optional, Filter by submission completion status. Defaults to all.
  • start_date · string · Optional, ISO 8601 date-time. Include submissions on or after this date.
  • end_date · string · Optional, ISO 8601 date-time. Include submissions on or before this date.
  • after_id · string · Optional, Return submissions after this submission id (cursor-style pagination).
  • page · number · Optional, Page number, starting at 1. Defaults to 1.
  • limit · number · Optional, Submissions per page (max 500). Defaults to 50.
Get Submission · Read

Get a single submission by id

get_submission · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • submission_id · string · Required, Obtain from List Submissions or the New Submission trigger payload.
Delete Submission · Read

Permanently delete a single submission

delete_submission · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • submission_id · string · Required, Obtain from List Submissions or Get Submission.
Get Form Metrics · Read

Get summary metrics for a form over a time period

get_form_metrics · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • period · string · Required
Get Form Visit Analytics · Read

Get visit counts over time for a form

get_form_visit_analytics · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • period · string · Required
Get Form Submission Analytics · Read

Get completed vs partial submission counts over time for a form

get_form_submission_analytics · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • period · string · Required
Get Form Analytics Dimensions · Read

Get visitor breakdowns by source, browser, OS, device, and location for a form

get_form_analytics_dimensions · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • period · string · Required
Get Form Drop-off Analytics · Read

Get per-question drop-off rates for a form

get_form_drop_off_analytics · Risk: low · Retry: safe

Inputs

  • form_id · string · Required
  • period · string · Required
List Workspaces · Read

List all workspaces in your Tally account

list_workspaces · Risk: low · Retry: safe

Inputs

  • page · number · Optional, Page number, starting at 1. Defaults to 1.
Create Workspace · Read

Create a new workspace

create_workspace · Risk: low · Retry: safe

Inputs

  • name · string · Required
Get Workspace · Read

Get a single workspace by id

get_workspace · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required
Rename Workspace · Read

Rename a workspace

rename_workspace · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required
  • name · string · Required
Delete Workspace · Read

Permanently delete a workspace and everything inside it

delete_workspace · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required
List Workspace Folders · Read

List folders inside a workspace

list_workspace_folders · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required
Create Folder · Read

Create a folder inside a workspace

create_folder · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required
  • name · string · Required
  • parent_id · string · Optional, Only folders inside the selected workspace are shown.
Rename Folder · Read

Rename a folder

rename_folder · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required
  • folder_id · string · Required, Only folders inside the selected workspace are shown.
  • name · string · Required
Delete Folder · Read

Delete a folder and its subtree, moving contained forms to trash

delete_folder · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required
  • folder_id · string · Required, Only folders inside the selected workspace are shown.
Get Current User · Read

Get the connected account's profile and subscription plan

get_current_user · Risk: low · Retry: safe

Custom API Call · Read

Make a custom API call to a specific endpoint

custom_api_call · Risk: low · Retry: safe

Inputs

  • url · object · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_is_binary · boolean · Optional, Enable for files like PDFs, images, etc.
  • failsafe · boolean · Optional, On a failed request, output the error instead of failing the step.
  • timeout · number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).
  • followRedirects · boolean · Optional, Follow 3xx redirects instead of returning them as the response.

Triggers

New Submission · Webhook

Triggers when a form receives a new submission

Inputs

  • form_id · string

Setup

Setup

  1. Add the Tally connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • No provider credential fields are declared by the pinned package.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-tally@0.6.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 25 actions and 1 trigger declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Tally connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-tally@0.6.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com