Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.avicenna.dev/llms.txt

Use this file to discover all available pages before exploring further.

By the end of this guide, you’ll have a fully working webhook listener that sends an email whenever someone submits your Tally form. You can see a working version of the final product here.
This guide may include intermediate to advanced concepts or terminology.

​
What You’ll Need

Below are the prerequisites you’ll need to follow along with this guide:
  • a Tally account (free)
  • a configured Resend integration in Avicenna (if you want to send an email)

​
1. Create a Tally Form

1

Create a new form

Log in to Tally and create a new form (let’s call it “Submit a Suggestion)
2

Add a question

Add a short answer or long answer question to your form (you can word the question however you wish)
Image
3

Publish your form

Once your form looks something like the image above, you can go ahead and publish it!

​
2. Create a Listener Endpoint

1

Create a POST endpoint

From the Avicenna Dashboard, create a new POST endpoint (we’ll name ours /tally-listener).
Image
2

Add request body keys

Tally will send information about the form submission via the request body. Add the eventId and data keys to the request body. 
A full example of the request body Tally sends can be found here.
Image
3

Add an action block

Add the Send Email action to your workflow and connect it to the base starting block.
If you don’t want to send an email, you can instead use a different action such as Send External Request to trigger something else.
Image
4

Customize your email body

You can customize your email’s body however you like. Use the variables listed below to add content from the Tally form submission:
  • {body.data.fields.0.value} - Returns the answer to the first question in your form
  • {body.eventId} - Returns the event ID of the Tally form submission
A full example and list of keys that are returned by Tally and can be accessed through variables can be found here.
5

Deploy your endpoint

Add a simple Respond action to tell Tally that you received the webhook. You’re then ready to deploy the endpoint!
Image

​
3. Configure Tally Webhook

1

Copy endpoint URL

Copy the endpoint URL for your webhook listener.
Image
2

Add Tally webhook integration

Navigate to the Integrations tab from the Tally settings page for your form. Click Connect under the “Webhooks” option.
Image
3

Configure webhook integration

Paste your Avicenna listener endpoint’s URL in the **Endpoint URL **field. If your API requires authentication, add an API key in the HTTP Headers field. Click Connect once you’re done.
Screenshot 2026 05 04 At 6 02 06 PM

​
4. All done!

Try submitting a response to your Tally form and watch your Avicenna endpoint run! You can check your endpoint’s logs from the Avicenna Dashboard to verify that the webhook executed. Try out a working version of this Tally setup we’ve made here: https://tally.so/r/zxJLM8!

​
Frequently Asked Questions

No, this setup works fine with Tally’s free plan!
Yes. Instead of the Send Email action, you can use the Send External Request action to call any third-party service or API of your choice.
You can use {body.data.fields.1.value} for the second field, {body.data.fields.2.value} for the third, and so on. The full list of available keys is documented in Tally’s webhook reference.
Authentication is optional. If your API requires it, you can add an API key in the HTTP Headers field when configuring the Tally webhook integration.