Use Cases



Forms and Form Webhooks

Working with html forms and utilizing Webhooks in Zesty.io WebEngine

HTML pages rendered in WebEngine have access to a few ways to capture form data, render form data, or to send form data.

Capturing Form Data to an Instance's Leads Feature


Zesty.io Leads is feature of zesty that lets you capture user submitted data through an HTML form. Data is captured through <form> POSTs. Here is an example:

Upon POST submission, Zesty.io will look for an input named zlf (Zesty Lead Form), and if it finds it, it will capture the form data to the leads table which can be viewed ini the Zesty.io Manager app of the instance the submission occurred on. The value you set for zlf is captures as the form name, you can use this value to organize your leads into groups.

If you want to learn more about leads, have a look at the leads api https://instances-api.zesty.org/?version=latest#6ba715eb-485f-4a4b-8e8a-f2f3fa81e9a1

Sending Form Data to an Email or Through a Webhook


There is built in functionality to send form data to an email address that is set in Zesty.io Manager Settings, under contact form. Alternatively you can have a payload sent to any remote server using a Webhook. That is often used for custom integrations or used with systems like Zapier.

Sending Form Data to an Email

In your HTML form, you can add an input with the name zcf, (Zesty Contact Form) when that exists, Zesty.io WebEngine will detect it and send an email to the email set in contact form settings or the optional email_override input.

email_override is often used for dynamic forms that change who the need to email. This value could be changed dynamically by Javascript based on user input. A good example is changing the email based on the department like support or billing, or based upon the location like state.

Sending Form Data via Webhook

In your HTML form you can add an input with the name _zesty_webhook (Zesty Webhook), which WebEngine will look for. If WebEngine see _zesty_webhook it will attempt to send a POST request to the value of _zesty_webhook which should be the url of the remote service you wish to send a payload too. Let's look at a code:

Upon submission Zesty WebEngine will capture that post and send a payload to the _zesty_webhook value, which in our example is a Zapier url. The payload will look like this:

The verification key is an MD5 hash of your Instance ZUID, you can use this to prevent spam from hitting your endpoints.

Using All Three Capture Methods


It possible to use all three methods in conjunction, so go nuts, but don't hurt yourself!

Handling Form Data with Parsley


Sometimes its nice to customize your page base on the user's input. You can access values of a form post in parsley like this:

Connect with Content Experts

Book a free 15-minute consultation with a content expert. Discuss your application, pain points and requirements. Understand how Zesty's lower total cost of ownership, features, functionality can elevate your business by creating extraordinary digital experiences.

Trusted By

zesty customer logo Sonyzesty customer logo Rocket Leaguezesty customer logo Singlifezesty customer logo Acornszesty customer logo Phoenix Sunszesty customer logo Wattpadzesty customer logo Corner Shopzesty customer logo Bjs


zesty customer logo zesty customer logo zesty customer logo zesty customer logo

Enter your details to connect with a Content Expert

First Name

Last Name


Phone (optional)


Please tell us about your project (optional)