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

# Integrate Tally

Sync Tally form submissions to create partners or customers automatically. Partnero offers two integration methods:

1. Direct form link
2. From linked from website

We'll go through both methods below. These instructions with auto-generated code snippets can be found on your Partnero account, under   **Integration** > **Tally**: <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/95cf9a63.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=c21d3e24c0eedafbfadb103d3050bbb0" alt="" width="2850" height="1560" data-path="images/articles/integrate-tally/95cf9a63.webp" />

***

### Method 1: Direct form link

Choose this when partners share a direct link to your Tally form with their referral key in the URL, for example:

[https://tally.so/r/YOUR\\\_FORM\\\_ID?aff=PARTNER\\\_KEY](https://tally.so/r/YOUR\\_FORM\\_ID?aff=PARTNER\\_KEY)

Tally automatically captures URL parameters into hidden fields, no scripts needed.

#### Step 1: Add a hidden field to your Tally form

1. Open your form in the Tally editor.
2. Add a Hidden fields block to your form: <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/893f16cb.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=022b554c9251fe05c43c05b69c6bf125" alt="" width="2876" height="1558" data-path="images/articles/integrate-tally/893f16cb.webp" />
3. Create a hidden field named aff: <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/3a9fb865.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=2e20a86fe3737df025a161210faf7d2e" alt="" width="2874" height="1562" data-path="images/articles/integrate-tally/3a9fb865.webp" />
4. Publish your form.

#### Step 2: Connect Tally in Partnero

1. Go to **Integrations** in your Partnero dashboard.
2. Find **Tally** under Forms and click **Connect**: <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/a65298c9.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=5d7dbf3ec7bf502c3b123d9c07568e32" alt="" width="2850" height="1558" data-path="images/articles/integrate-tally/a65298c9.webp" />
3. In [Tally account](https://tally.so/settings/api-keys) [settings,](https://tally.so/settings/api-keys) create a new API key and add it to Partnero. Click **Connect**.  <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/c1bebdf3.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=2db9ce2afed23002df69692aeeb1f968" alt="" width="2872" height="1334" data-path="images/articles/integrate-tally/c1bebdf3.webp" /><img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/35abb510.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=c087c4adcaf57ef54688f72035cf430d" alt="" width="2876" height="1564" data-path="images/articles/integrate-tally/35abb510.webp" /><img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/5884527a.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=8ab2facc3a723aa960c8ed71933a46ff" alt="" width="2852" height="1558" data-path="images/articles/integrate-tally/5884527a.webp" />
4. Select your form, choose an action (create partner or customer), and map the fields.
5. Make sure to map the hidden field to the Partner key: <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/e6a904e4.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=96017dc7cd04ad5126f6db6c2b2b3977" alt="" width="2850" height="1556" data-path="images/articles/integrate-tally/e6a904e4.webp" />

That's it! When someone opens the form link with a partner key in the URL, Tally captures it in the hidden field and sends it to Partnero via webhook.

#### Sales tracking

To complete the integration, you need to share details of successful sales with Partnero. You can do this in a few ways:

* Use Stripe or Paddle Billing integrations
* Implementing tracking through the [Partnero API](https://docs.partnero.com/guides/tracking/affiliate-api#sending-sales-data)
* Implementing tracking through the [Partnero JS](https://docs.partnero.com/guides/tracking/javascript-tracking#sales-tracking)
* Use Zapier or Make to connect everything.

***

### Method 2: Form linked on website

Choose this when your website has Partnero tracking installed and contains a link to a Tally form. A small script will read the referral key from the tracking cookie and append it to your Tally form links automatically.

#### Step 1: Install the tracking script on your website

Add the PartneroJS snippet to your website to track visitors and store the referral key in a cookie. The PartneroJS snippet can be found under  **Integration** → **Program details**: <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/44a8b009.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=44a3ba87d081b1cb14abf0c2b16bcc86" alt="" width="2878" height="1574" data-path="images/articles/integrate-tally/44a8b009.webp" />

#### Step 2: Add a hidden field to your Tally form

1. Open your form in the Tally editor.
2. Add a **Hidden fields** block to your form.
3. Create a hidden field named aff.
4. Publish your form.

#### Step 3: Add the link script to your website

Open the Tally setup guide on your Partnero account. Switch to the **Form linked on website** tab and scroll to Step 3: <img src="https://mintcdn.com/partnero/TD1h4eRbwmmE0XYt/images/articles/integrate-tally/ad1236ef.webp?fit=max&auto=format&n=TD1h4eRbwmmE0XYt&q=85&s=0b851a7a3818461ff6fc39499d15e154" alt="" width="2840" height="1560" data-path="images/articles/integrate-tally/ad1236ef.webp" />

If you use a custom domain for your Tally forms (e.g., forms.yourcompany.com), add it to the  **Tally form domain** field. Otherwise, leave the default.
Copy the provided script. Add it to the pages that contain Tally forms.

#### Step 4: Connect Tally in Partnero

1. Go to **Integrations** in your Partnero dashboard.
2. Find Tally under Forms and click **Connect**.
3. Enter your Tally API key (from [Tally account settings](https://tally.so/settings/api-keys)).
4. Select your form, choose an action (create partner or customer), and map the fields.
5. Make sure to map the hidden field to the Partner key.

When a referred visitor clicks a Tally link on your website, the script appends the partner key to the URL. Tally captures it in the hidden field and sends it to Partnero via webhook.

#### Sales tracking

To complete the integration, you need to share details of successful sales with Partnero. You can do this in a few ways:

* Use Stripe or Paddle Billing integrations
* Implementing tracking through the [Partnero API](https://docs.partnero.com/guides/tracking/affiliate-api#sending-sales-data)
* Implementing tracking through the [Partnero JS](https://docs.partnero.com/guides/tracking/javascript-tracking#sales-tracking)
* Use Zapier or Make to connect everything.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.