Tally Developer Docs

API Reference

Documentation

Request Access

Support

Help Center

Returns information about the current authenticated user, including organization details and access permissions.

Get the current user

bearerAuth

Retrieve current user information

Introduction

API keys

Creating an empty form using the Tally API

Creating a form

Add new blocks to an existing form using the Tally API

Adding blocks to a form

Learn how to style your form title blocks using the Tally API

Styling title blocks

Retrieve submissions for a form using the Tally API

Fetching form submissions

Learn how to create a contact form using the Tally API

Creating a contact form

Learn how to create a form with a dropdown using the Tally API

Creating a dropdown

Learn how to create a form with a mention using the Tally API

Creating a mention

Learn how to create a form with settings using the Tally API

Creating a form with settings

List forms

Creates a new form, optionally based on a template or within a specific workspace.

Create a form

Returns a single form by its ID with all its blocks and settings.

Get a form

Updates a form's settings, blocks, or status.

Update a form

Deletes a form by its ID and moves it to the trash.

Delete a form

Returns a paginated list of form submissions with their responses.

List form submissions

Deletes a specific submission from a form.

Delete a form submission

Returns an array of workspace objects with associated users and pending invites.

List workspaces

Creates a new workspace and assigns the authenticated user as a member. Requires a Pro subscription.

Create a workspace

Returns a single workspace by its ID with associated members.

Get a workspace

Updates a workspace's information by its ID.

Update a workspace

Deletes a workspace and all its associated forms. The workspace and forms are moved to trash and can be restored later. Forms in DRAFT or PUBLISHED state will be marked as DELETED.

Delete a workspace

Creates a new webhook for a form to receive form events.

Create a webhook

Updates an existing webhook configuration.

Update a webhook

Deletes a webhook. If this is the last webhook for a form, the webhooks integration will also be marked as deleted.

Getting started

Users

Forms

Form submissions

Workspaces

Webhooks

Get the current user

Authorizations

Response