Tally

Connect Tally forms to your workspace to add or update people and trigger automations when they submit your form. Our Tally integration relies on a webhook from Tally.

How it works

When you set up a Tally integration, Customer.io gives you a personalized Webhook URL. You add this webhook URL to your form in Tally. Whenever someone submits your form, Tally sends the form submission data to Customer.io.

Each submission creates a profile in your workspace if one doesn’t already exist, or updates the profile if it does. Customer.io saves each answer to an attribute on the profile and records a form_submit event. Customer.io names the attributes for you, based on your form, and you can change the mappings after the first submission.

You can also trigger automations when people submit your form. This provides a handy way to send personalized responses. You can personalize responses with liquid using either customer attributes that you assign from form submissions ({{customer.<attribute>}}) or form fields from the form_submit event ({{event.<field_ID>}}).

sequenceDiagram participant A as Person participant B as Tally participant C as Customer.io A->>B: Submits form B->>C: form_submit event rect rgb(229, 254, 249) C-->>C: Every form submission:<br>Sync form fields to attribute mappings end C->>C: Create or update profile C-->>A: Optional response automation<br>("Thanks for your response!")

Connect Tally to your workspace

As a part of this process, you’ll add a webhook to your Tally form. After someone submits your form, it appears in your workspace on the Integrations > Forms page. Then you can map form fields to attributes.

  1. Go to Integrations > Forms. Click Connect form and select Tally.

  2. Click Copy to get your webhook URL.

    Copy your Tally webhook URL
  3. In Tally, publish your form. Then go to your form’s Integrations tab and click Connect next to Webhooks.

  4. Paste the URL you copied as the endpoint and click Connect.

Now, Customer.io is set up to capture submissions from your Tally form. We suggest that you send a test submission so that you can see how your form’s fields map to attributes in Customer.io. This gives you the opportunity to re-map fields to attributes before you share your form with a wide audience.

Customer.io only receives submissions that Tally sends to the webhook. If someone submits your form before you connect the webhook, or while the webhook is paused in Tally, that submission doesn’t reach Customer.io.

Moving from a webhook-triggered automation

If you already send Tally submissions to a webhook-triggered automation, you can connect the Tally integration while that automation continues to run. Tally will send each submission to both webhooks until you disconnect the webhook-triggered automation, so you can ensure that your Tally integration is set up correctly before you delete the old webhook.

How Customer.io maps your form’s fields

When a submission includes a field that Customer.io hasn’t seen before, we map it to an attribute . You can update mappings after a submission, but the initial mapping looks like this:

  • Email: We use the first Email block on your form (Questions > Email in Tally) as the email attribute of the person who submitted the form. If your form doesn’t have an Email block, you can identify people with a hidden field named email. If your form has both when someone first submits it, the Email block identifies the person. If you add an Email block later to a form that already identifies people with a hidden email field, the new block stays unmapped until you map it.
  • Questions: We convert the question text to an attribute name in snake case, limited to 40 characters. For example, a question titled “What is your name?” becomes a what_is_your_name attribute. We drop any character that isn’t a letter from A to Z or a digit, so Correo electrónico becomes correo_electrnico. If a question has no letters from A to Z or digits, we don’t create an attribute for it, and you need to map it yourself.
  • Hidden fields: We convert the hidden field’s name to snake case. We treat -, _, and a capital letter after a lowercase letter as the start of a new word. For example, utm-source, UTM_Source, and utmSource all map to utm_source, and originPage maps to origin_page.

When you add a field to your form, we map it the next time someone submits your form. If you rename a question in Tally, it keeps the attribute it already maps to. If you update a mapping in Customer.io, the attribute name you set persists across later submissions.

A blank answer clears the attribute that the question maps to. If someone who’s already in your workspace skips an optional question, or your form hides a question with logic, Customer.io removes that attribute from their profile.

If you delete a field mapping in Customer.io while the field still exists in your Tally form, the next submission adds the mapping back with a generated attribute name. To stop capturing a field, remove it from your form.

Fields that identify people

In general, forms contain an Email block and one or more questions. The Email block identifies the person who submitted the form, and the questions contain the person’s answers.

But you can use other fields to identify people.

  • Phone numbers: If your workspace identifies people by phone number, map your phone question to the phone attribute. By default, Tally’s Phone number block maps to a phone_number attribute, which doesn’t identify anyone. Phone numbers must be in E.164 format, like +14155550123. A phone number identifies the person only when the submission doesn’t include an email address or ID. Otherwise, Customer.io saves the number to the person’s phone attribute.
  • Workspaces that identify people by ID: If your workspace identifies people by ID only, the Email block doesn’t identify anyone. Map a field to id instead, such as a hidden field named id.

Map form fields to attributes

After someone submits your form, you can change the attribute that each field maps to. Do this before you share your form widely, so that answers land on the attributes you already use.

  1. If you haven’t already, submit a test response to your published form in Tally.

  2. In Customer.io, go to Integrations > Forms and refresh the page.

  3. Click and select Manage form.

  4. Click Edit under Mapped fields to set the attributes for each form field. In each field, you can select an existing attribute or type in a new one.

  5. Click Save changes when you’re done.

Now you can take advantage of form submissions to trigger automations, personalize messages, and more. See Use form data in Customer.io for more information.

Tally field types

Tally sends some answers in formats that affect how you use them in Customer.io. Customer.io stores every answer as a string, including answers that Tally sends as a list.

  • Multiple choice, dropdown, checkboxes, multi-select, and ranking: stored as a JSON array of strings, even when someone picks one option. For example, a single choice arrives as ["Pro"], and checkboxes arrive as ["Surf","Golf"]. A ranking keeps the person’s order, like ["Pear","Apple","Banana"]. In segments and filters, use contains instead of equals, because equals Pro doesn’t match ["Pro"]. Keep in mind that contains Pro also matches a longer option, like Pro Plus.
  • Matrix: stored as a JSON object with one key per row, where each row holds a JSON array of strings. For example, {"Quality":["Satisfied"],"Speed":["Neutral"]}.
  • Numbers, ratings, dates, and times: stored as strings in the format Tally sends. For example, a number is 10, a rating is 4, a date is 2026-11-10, and a time is 14:30.
  • File uploads and signatures: stored as a JSON array of strings, one file URL per string. For example, ["https://storage.googleapis.com/tally-response-assets/.../photo.png"]. Anyone with the URL can open the file.
  • Payment: becomes five separate, top-level attributes for the price, currency, name, email, and link. Customer.io names them from Tally’s labels like any other question. For example, Tally labels the price Payment (price), which maps to a payment_price attribute. The payer’s email doesn’t identify the profile.

Tally’s popup and standard embeds pass the page’s URL parameters into hidden fields with matching names, such as utm_source and utm_campaign. A hidden field named originPage captures the page’s path, which Customer.io stores as an origin_page attribute.

To pre-fill an email address in a link from one of your messages, use {{customer.email | url_encode}}. The url_encode filter keeps a + in an email address from turning into a space.

Find recent Tally submissions

  1. Go to Integrations > Forms.

  2. Click and select Manage form for your Tally form.

The Submissions card shows recent submissions. Click a submission to see details for that form.

Use form event data in Liquid

In many cases, it’s easier to use profile attributes than form event data in liquid . But if you need to use a field from the form_submit event, you need its field ID, such as {{event.question_3EKz4n}}. You can see your form’s field IDs by selecting Field ID at the top of the mapping table. A hidden field’s ID is its name.

Updated November 19, 2026