The WPForms workflow trigger, labeled WPForms Submitted, starts a workflow when WPForms processes a form entry. It passes submitted values and entry details to later workflow nodes.
Screenshot to add: WPForms Submitted trigger node showing the optional Form ID setting
Requirements
- WPForms must be active. The plugin registers this integration only when WPForms is detected.
- Create the WPForms form and fields that should provide data to the workflow.
Configure the trigger
- Open Agent Workflows and edit the workflow.
- Add the WPForms Submitted trigger node.
- Optionally enter a value in Form ID (optional — leave empty for all forms). Leave it blank to accept processed submissions from any WPForms form.
- Connect the trigger to the next node and map the submitted values using the variable picker.
- Save the workflow and test with a controlled form submission. Inspect the payload and confirm the mapped fields before activating it for normal use.
Understand the trigger data
The payload includes source (wpforms), event (form_submitted), form_id, form_title, entry_id, a fields object keyed by field ID, and a fields_by_label object keyed by field name. Array field values are converted to comma-separated text.
Filter by form
The trigger listens to WPForms’ wpforms_process_complete hook. If you enter a form ID, submissions from other forms are ignored. Leave the setting blank only when the workflow should respond to all processed WPForms submissions. Editor sample data is not a substitute for testing a real submission.