Skip to content

Open source website builder and Webflow alternative. Webstudio is an advanced visual builder that connects to any headless CMS, supports all CSS properties, and can be hosted anywhere, including with us.

4.9 KB
Raw Blame

description: >- Deprecated. Existing Webhook Forms send submissions to an email address or optionally third-party services like Airtable, n8n, or Zapier.

✍️ Webhook Form

{% hint style="info" %} Deprecated: Webhook Form remains supported through the next release and will be removed afterward. Use the new Form for Resource actions or URL-based navigation, or an Element with tag form for native browser form behavior. {% endhint %}

{% embed url="https://www.youtube.com/watch?v=eE-CkewQHMs" %}

Receiving form submissions

Webhook Forms are used when you need to send form submission data to an external service, rather than modifying page content like searches and filters.

Email notifications

By default, submissions are sent to the project owner.

{% hint style="info" %} Pro feature: You can customize the recipient of email notifications by navigating to Project settings > Emails.

{% endhint %}

Webhooks

You can also send form submission data to a webhook—an external URL that receives the data and triggers an action, such as adding a contact to an email automation platform.

  1. Obtain a webhook URL from a third-party platform such as Airtable.
  2. Paste the URL into the Action field in Webhook Form > Settings.

Once set up, every form submission will send a payload (form fields and values) to the webhook URL.

Using the Webhook Form component

Existing projects can keep and edit their saved Webhook Form instances. The component is no longer available for new insertion; use the new Form for new Resource submissions.

{% hint style="warning" %} Webhook Forms do not submit inside the Builder, including in Preview. They only submit on the published site. {% endhint %}

Webhook Form structure

A Webhook Form consists of three nested instances:

  1. Form content – The primary form fields.
  2. Success message – Displayed upon successful submission.
  3. Error message – Shown when an error occurs.

You can add new inputs to further expand and modify your form.

Form states

Webhook Forms automatically switch between states based on submission results.

Success message

When a submission is successful, users will see a success message. To customize it:

  1. Select the main "Form" instance and go to Settings.
  2. Change the State from "Initial" to "Success."
  3. Edit the success message directly on the canvas.

Error message

If there’s an error during submission, users will see an error message. To modify it:

  1. Select the Webhook Form component.
  2. Set the State to "Error" to preview and edit the error message.

Form inputs

{% hint style="warning" %} Each input field must have a name attribute for its data to appear in email notifications and webhook payloads. {% endhint %}

Ensure every form input has a value for the name field to be included in submissions.

Input Settings with Name set to email

For a full list of input types, including checkboxes and radio buttons, refer to Form inputs.

Input properties

Each input field has several configurable properties in Settings:

  • Name: The field identifier used in submissions (required for data to appear)
  • Type: Define the input type (text, email, tel, etc.). Setting type to "email" enforces email format validation.
  • Placeholder: Hint text shown inside the input before user enters data (e.g., "[email protected]")
  • Required: When enabled, the form cannot be submitted without this field
  • Autofocus: When enabled, this field is automatically focused when the page loads

Styling form states

You can create interactive form styling using states in the Style panel:

  • Hover: Apply styles when users hover over an input (e.g., wider border, box shadow)
  • Focus: Apply styles when an input is active/selected (e.g., colored border, glow effect)
  • Placeholder: Style the placeholder text appearance

To apply state-specific styles, select the input element, open the state dropdown in the Style panel, and choose the state you want to customize.

Bot protection

Webstudio forms include built-in bot protection to prevent spam submissions. This protection works automatically without requiring any additional configuration – no CAPTCHAs needed. The system analyzes submission patterns to distinguish between legitimate users and automated bots.

Related