> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your app to Tally

> Connect your app to Tally, the free-form builder, to create forms, fetch submissions, and manage form workflows from your Lovable app.

export const connector_0 = "Tally"

[Tally](https://tally.so/) is a form builder that lets you create forms and surveys without code. The Tally connector lets your Lovable app create forms, list the forms in your Tally workspace, and fetch their submissions through the Tally API. It's designed for apps that collect responses in Tally and work with them somewhere else, like dashboards, admin panels, and follow-up workflows.

With Tally, your app can:

* List the forms in your Tally workspace
* Fetch submissions and question metadata for a form
* Create forms and manage form workflows
* Verify the connected account

<Tip>
  For real-time workflows, prefer [Tally webhooks](https://tally.so/help/webhooks) pointed at an endpoint in your app instead of polling for new submissions.
</Tip>

## Common use cases and example apps

| Example app                    | Example prompt                                                                                             | Description                                                                                                                                    |
| :----------------------------- | :--------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |
| **Feedback dashboard**         | *Use Tally and build a dashboard that shows the latest submissions from my feedback form.*                 | **Turn form responses into a live dashboard.**<br />The app fetches submissions from Tally and renders them as browsable, filterable feedback. |
| **Lead follow-up tool**        | *Use Tally and build an app that lists new leads from my contact form and lets me mark them as contacted.* | **Manage form leads inside your app.**<br />The app pulls contact-form submissions and tracks follow-up status for each lead.                  |
| **Survey results explorer**    | *Use Tally and build a results explorer that charts the answers from my customer survey.*                  | **Visualize survey answers.**<br />The app reads submissions and question metadata and turns them into charts and summaries.                   |
| **Event registration manager** | *Use Tally and build an admin page that lists registrations from my event signup form.*                    | **Track event signups in one place.**<br />The app lists registrations with their answers so organizers can check people in.                   |
| **Forms overview**             | *Use Tally and build an overview page that lists all my Tally forms with submission counts.*               | **Surface your Tally workspace in-app.**<br />The app lists your forms so you can jump to the right one quickly.                               |
| **Instant submission alerts**  | *Use Tally webhooks to show new submissions in my app the moment they arrive.*                             | **React to new submissions in real time.**<br />The app exposes an endpoint that receives Tally webhooks and updates the UI instantly.         |

## How to connect Tally

Who can create Tally connections depends on your plan and workspace settings. See [Who can create connections](/integrations/introduction#who-can-create-connections).

You can create multiple Tally connections using different API keys, which is useful for separating environments (for example, development and production) or connecting multiple Tally workspaces.

When the connection is created, you can link it to the projects where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.

### Prerequisites

Before connecting Tally, make sure you have:

* A Tally account
* A Tally API key
* Permission to **create connections** in your Lovable workspace (see [Who can create connections](/integrations/introduction#who-can-create-connections))

<Note>
  All API requests made through this connector count toward your Tally account's rate limits. Billing and quota are handled directly by Tally, not Lovable.
</Note>

### Step 1: Get a Tally API key

An API key lets your Lovable app authenticate with the Tally API.

To create a Tally API key:

<Steps>
  <Step title="Open your Tally settings">
    Sign in to Tally and go to [**Settings → API keys**](https://tally.so/dashboard/settings/developers).
  </Step>

  <Step title="Create a key">
    Create a new API key and give it a descriptive name, for example `Lovable integration`.
  </Step>

  <Step title="Copy the key">
    Copy the key and store it securely. Tally API keys start with `tly-`.
  </Step>
</Steps>

<Warning>
  Your API key functions like a password. Keep it secure and never share it publicly. You'll need it in the next step.
</Warning>

See Tally documentation for more: [Tally API reference](https://developers.tally.so/api-reference/introduction).

### Step 2: Connect Tally to Lovable

<Steps>
  <Step title="Open Tally in Connectors">
    Go to **Connectors** and select **Tally**.
  </Step>

  <Step title="Add a connection">
    Click **Add connection**.
  </Step>

  <Step title="Configure the connection">
    1. **Display name**: name the connection, for example `Tally Prod`.
    2. **API key**: paste your Tally API key (it starts with `tly-`). Use **Open Tally** below the field to jump to the API keys settings if you need to generate one.
  </Step>

  <Step title="Choose who can use this connection">
    Under **Who can use this connection**, decide who in your workspace can use the connection. You start as the only person with access:

    * **Only you** (default): leave the access list as is; only you can use the connection and its associated data.
    * **Invite specific people**: add workspace members by email; only you and the people you add can use the connection and its associated data.
    * **Invite entire workspace**: click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

    See [Who can manage connections](/integrations/introduction#who-can-manage-connections) for more information.
  </Step>

  <Step title="Connect">
    Click **Connect**. Lovable verifies the key against Tally before saving the connection.
  </Step>
</Steps>

When connected, anyone building in a project can ask Lovable in chat to link their project to Tally (based on configured connection-level access). Your Lovable apps can then create forms, list forms, and fetch submissions through the connector.

## Limitations

The Tally connector cannot:

* Receive Tally webhooks through the connector. Configure Tally webhooks to call an endpoint in your app instead
* Refresh or rotate API keys automatically. To rotate, generate a new key in your Tally API keys settings and update the Lovable connection
* Support per-end-user Tally login. Each connection represents a single Tally account shared across all projects linked to it

## How to unlink projects from a {connector_0} connection

Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects.

To unlink projects:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors** and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

<Warning>
  Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors** and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>