What Are Form Actions?
You can configure a form to trigger a front-end event when it is submitted. The event can send a custom request or call a plugin, enabling data interaction and customized business processing.
When to Use This Feature?
This feature is suitable for scenarios where custom business operations need to be performed immediately when a form is submitted. For example:
Sync order data to another system after an order is submitted.
Call a plugin to generate the required business records after a registration form is submitted.
Push lead data to a specified endpoint after customer information is submitted.
Trigger custom validation or processing logic after an approval request or work order is submitted.
What Does It Look Like?
Take a budget request as an example. When an employee submits an expense request, a front-end event is triggered to retrieve the real-time available balance of the corresponding budget account from an external financial system.
The balance is automatically populated into the form and used to validate the submission, preventing requests that exceed the available budget.
Plan Description
This is a paid advanced feature. For details, contact our Sales Team.
How to Configure Form Actions?
You can create a front-end event with Form Submission as its trigger from either of the following entry points:
Entry Point | Description |
Form Properties > On Form Submission > Actions | Manages only front-end events whose trigger is set to Form Submission. |
Form Properties > Front-End Event | Provides a centralized location for managing all front-end events in the form. |
Note: Only one front-end event can be triggered when a form is submitted.
1. Adding an Action under On Form Submission
Open the form design page and go to Form Properties > On Form Submission > Actions. Click Add Action and select one of the following action types:
Custom Request: Sends a request to a specified endpoint when the form is submitted. You can also build an API based on your business requirements to perform custom operations such as retrieving data, validating data, analyzing data, and triggering events.
Call Plugin: Calls an installed plugin when the form is submitted.
Notes:
This entry point displays only front-end events whose trigger is set to Form Submission.
For front-end events created from this entry point, the trigger is set to Form Submission by default. To change the trigger, go to Form Properties > Front-End Event.
Method 2 Adding an Event under Front-End Event
Open the form design page and go to Form Properties > Front-End Event. Add a front-end event and set Trigger to Form Submission.
A front-end event created through this entry point with Form Submission as its trigger will also appear and take effect under On Form Submission > Actions.
Notes
For front-end events triggered on form submission, you can only select installed plugins that provide a Back-End Function.