Tally.so

Interact with Tally.so forms and submissions

Actions10

Form → Create Form

AI-generated

Overview

This node operation creates a new form in Tally.so using a provided JSON structure or incoming item data. It allows specifying the target workspace, whether to publish the form immediately after creation, and the final status of the form (Draft, Published, or Blank). It supports a dry-run mode to preview the form creation without actually sending the request, outputting the proposed form blocks and a diff for review.

Use Case Examples

  1. Creating a new survey form from a JSON template and immediately publishing it in a specific workspace.
  2. Using incoming data from a previous node to create a form dynamically, with the option to keep it as a draft for further editing.
  3. Previewing the form creation process without making changes to verify the form structure and content.

Properties

Name Meaning
Form JSON Full form JSON to create. If empty, uses incoming item data from $json.form or $json.
Workspace Target workspace for the new form. If empty, the first available workspace for the credentials is used.
Publish After Create If enabled, immediately publish the newly created form so it appears in Get All results.
Final Status What status to set after creating the form (Draft, Published, or Blank).
Dry-Run / Preview If enabled, do not actually create the form. Instead, output proposed blocks and a diff for preview.

Output

JSON

  • created - Indicates the form was successfully created.
  • form - The created form object with its details.
  • statusUpdatedTo - The final status set on the form after creation (e.g., Draft, Published, Blank).
  • preview - Indicates this output is a preview of the form creation (dry-run mode).
  • createNew - Indicates a new form creation action in preview mode.
  • createBody - The full form JSON body proposed for creation in preview mode.
  • patchBody - The patch body with blocks, name, and settings proposed for creation in preview mode.
  • targetStatus - The target status for the form in preview mode.

Dependencies

  • Tally.so API key credential

Troubleshooting

  • Ensure the provided Form JSON is valid and contains a blocks array; otherwise, the node will throw an error indicating no valid form JSON was found.
  • If the dry-run option is enabled, the node will not create the form but output a preview; disable dry-run to perform actual creation.
  • If specifying a workspace, ensure the workspace ID is valid and accessible with the provided credentials.
  • Common errors include form JSON parsing errors and API request failures; check the error messages for details and verify API credentials and network connectivity.

Discussion