Log inCreate a free account

Language

Log inCreate a free account
Documentation menu

Tally: your respondents

Add the people who fill in your Tally form to Mailcheer: a webhook on every submission, free on all Tally plans, a test, and picking the email field.

Every time someone submits your form, Tally can send their response to a web address the moment it arrives. That is a webhook. Give it your Mailcheer inbound webhook URL and the respondent lands in your contacts, with no export and no import.

Before you start

  • A Mailcheer inbound webhook. In Mailcheer, open Integrations → Bring in contacts and click Create an inbound webhook. Mailcheer gives you an address that looks like https://mailcheer.com/api/in/<token>. Treat it as a secret and never publish it: anyone who has it can send data to it.
  • No paid plan needed. Tally says webhooks are free for all of its users.
  • A published form. Tally asks you to publish the form before you add the webhook.
  • A question that asks for the email address in your form.

Only bring in people who have agreed to receive your emails, and say so clearly in your form. Double opt-in (a confirmation email) is on by default in Mailcheer.

1. Create the webhook in Tally

  1. Publish your form, then open its Integrations tab.
  2. On the Webhooks card, click Connect.
  3. In the Add a webhook endpoint window, paste your Mailcheer inbound webhook URL into Endpoint URL.
  4. Click Connect.

The webhook then appears under My connections, at the top of the Integrations tab. Its toggle pauses it or turns it back on.

The window offers two options, both optional:

  • Add a signing secret: Tally then signs every request in a Tally-Signature header. You can do without it.
  • Add HTTP headers: adds headers of your choice to every request.

2. Send a test

To test, fill in the form yourself:

  1. Open your published form and fill it in with your own email address.
  2. Submit it.
  3. On the Integrations tab, click the clock icon next to the webhook. The log lists every request sent to your inbound webhook URL.

Mailcheer replies right away and processes the submission afterwards.

3. Pick your fields in Mailcheer

Go back to your inbound webhook in Mailcheer. It shows what it received, along with the list of fields it found.

Tally sends the response as JSON. It sits inside data, in a list called fields, where each field carries its label (label), its type (type) and its value (value). An email question has the type INPUT_EMAIL. That is the field to look for.

Then choose, with a click:

  • the field that holds the email (required);
  • the first name and last name, if you want them;
  • tags: fixed ones (such as tally) or taken from a field;
  • double opt-in, on by default;
  • the automation to trigger, if you have one.

To bring in people you already have, use a file instead: see Import your contacts.

If it does not work

Start by looking at what Tally sent: Integrations tab → clock icon next to the webhook.

  • The webhook is paused. Check its toggle under My connections.
  • The address is incomplete. The pencil icon next to the webhook lets you edit the address. Compare it with the inbound webhook URL shown in Mailcheer. It must be copied in full, with no extra space or character.
  • Nothing in the log. Make sure you submitted the published form, and that the webhook belongs to that form: each form has its own Integrations tab.
  • Requests keep failing. When a request does not go through, Tally retries five times, spacing the attempts from 5 minutes up to 1 day. If every retry fails, Tally emails the form owner with the reason and a link to fix it.

Sources