GoRunner docs
Search or askSearch⌘K

Tally

Read and delete Tally submissions, create, change and delete forms, and look up questions and workspaces.

12 actions · 1 trigger · Paste an API token

Connect Tally

  1. In the sidebar, open Connections and press Add connection.
  2. Type tally and choose Tally.
  3. Fill in the fields. Each one says Required or Optional.
  4. Press Test and save. GoRunner checks the connection before it saves anything.

The sheet asks for:

API key · Required

A Tally API key (tly-…).

Paste a Tally API key (Tally → Settings → API keys → Create API key). The key acts as the person who made it: it reaches their workspaces and forms.

Connections says how to sign in again, rename or delete it. In a product that embeds GoRunner, Add connection can be missing: then your provider makes connections for you.

Start a workflow

Add a trigger and choose Tally. The trigger uses the same connection as the steps.

On New Response

Starts a run as soon as someone submits the form. Publishing the workflow adds a webhook to the form in Tally (with a signing secret kept encrypted); unpublishing removes it. Every delivery's Tally-Signature is checked and an unsigned or wrongly signed one is refused; a delivery Tally sends again (the same eventId) starts no second run.

Form · Required

The form whose responses start a run.

A later step can use its data, such as {{trigger.createdAt}}, {{trigger.eventId}}, {{trigger.fields}} and 6 more. See Use data from earlier steps.

Do things in Tally

Add a Tally step, choose a Resource, then an Operation. Choose a row to see its fields.

Later steps read a step’s output by its name: see Use data from earlier steps.

Limits

  • A reply from Tally can be up to 16 MB (a file download can have its own limit). A larger one fails the step; it is never cut short.
  • When Tally says to slow down (429), the step waits as long as it asks, if the step’s time allows. Otherwise it fails and says when to try again.

Not in your list? See When an app isn’t here.

For developers

In the API, which calls apps pieces, Tally is pieceId: "tally" with actionId: "tally", set by resource and an operation_… field, such as operation_form. Its trigger is tallytrigger / tally_response. Get an app returns every field.

It can change something outside the run (writes_external). See How versions and side effects work.

Tally › Submission

Get and Delete

Form · Required

The form the submissions belong to.

Submission ID · Required

The submission's id.

Get Many

Form · Required

The form the submissions belong to.

Submissions · Optional

Completed submissions, partial ones (left before the end), or both.

Options: All, Completed, Partial.

Default: Completed.

Since · Optional

Only submissions made at or after this time (ISO 8601).

Until · Optional

Only submissions made at or before this time (ISO 8601).

After Submission · Optional

Only submissions that came after this submission id.

Return All · Optional

Read every submission, page by page (at most 2000; past that the step fails rather than stop early).

Off by default.

Limit · Optional

How many submissions to return (1–2000).

Default: 50.

Shows when Return All is off.

Tally › Form

Create

Workspace · Optional

The workspace the new form goes in. Empty: the default one.

Start From · Optional

The id of a ready-made Tally form to start from. Empty starts blank.

Status · Optional

Draft or published. On Update, Unchanged leaves it; Published without new blocks publishes the saved draft.

Options: Unchanged, Draft, Published, Blank.

Default: Unchanged.

Blocks · Optional

The form's content as Tally's blocks, such as [{"uuid": "…", "type": "FORM_TITLE", "groupUuid": "…", "groupType": "TEXT", "payload": {"title": "Contact us"}}]. Update replaces all blocks. Empty on Create makes a blank form.

Settings · Optional

Form settings as Tally takes them, such as {"language": "en", "isClosed": false}.

Get and Delete

Form · Required

The form to read, change or delete.

Get Many

Workspace · Optional

Only forms in this workspace. Empty lists every form.

Return All · Optional

Read every form, page by page (at most 2000; past that the step fails rather than stop early).

Off by default.

Limit · Optional

How many forms to return (1–2000).

Default: 50.

Shows when Return All is off.

Update

Form · Required

The form to read, change or delete.

New Name · Optional

A new name for the form. Empty leaves it as it is.

Status · Optional

Draft or published. On Update, Unchanged leaves it; Published without new blocks publishes the saved draft.

Options: Unchanged, Draft, Published, Blank.

Default: Unchanged.

Blocks · Optional

The form's content as Tally's blocks, such as [{"uuid": "…", "type": "FORM_TITLE", "groupUuid": "…", "groupType": "TEXT", "payload": {"title": "Contact us"}}]. Update replaces all blocks. Empty on Create makes a blank form.

Settings · Optional

Form settings as Tally takes them, such as {"language": "en", "isClosed": false}.

Tally › Question

Get Many

Form · Required

The form whose questions to read.

Tally › Workspace

Get

Workspace · Required

The workspace to read.

Get Many

Return All · Optional

Read every workspace, page by page (at most 2000; past that the step fails rather than stop early).

Off by default.

Limit · Optional

How many workspaces to return (1–2000).

Default: 50.

Shows when Return All is off.

Tally › Account

Get Me

Nothing to fill in.