WPForms Trigger icon

WPForms Trigger

Starts a workflow when a WPForms form is submitted

Overview

This node acts as a trigger that starts an n8n workflow when a WPForms form is submitted. It listens for incoming webhook POST requests from WPForms, verifies the request using a secret key, and then outputs the form submission data in one of two formats. This node is useful for automating processes based on user submissions through WPForms, such as sending notifications, updating databases, or integrating with other services.

Practical examples:

  • Automatically send a thank-you email when a user submits a contact form.
  • Log form entries into a CRM system.
  • Trigger follow-up workflows based on specific form responses.

Properties

Name Meaning
Secret Key The secret key used to verify the authenticity of incoming webhook requests. This key should match the one configured in your WPForms n8n settings to ensure secure communication.
Output Schema Determines the format of the output data emitted by the trigger:
- Default: Emits one item containing properties form, entry, fields, and meta representing structured form submission data.
- Raw: Emits one item containing raw body and headers from the webhook request.
Timestamp Skew The allowed time difference (in seconds) between the server and client timestamps to account for clock skew when validating the request's timestamp. Default is 300 seconds (5 minutes).

Output

The node outputs a single item per webhook event with JSON data structured according to the selected output schema:

  • Default output schema:
    The output contains these main properties:

    • form: Information about the submitted form.
    • entry: Details of the form entry/submission.
    • fields: The individual fields and their values submitted by the user.
    • meta: Metadata related to the submission or request.

  • Raw output schema:
    The output contains:

    • body: The raw body of the webhook POST request as received.
    • headers: The HTTP headers sent with the webhook request.

The node does not output binary data.

Dependencies

  • Requires a valid secret key configured both in WPForms and this node to verify incoming webhook requests.
  • Relies on WPForms sending webhook POST requests to the node’s webhook URL.
  • No external API keys or additional credentials are required beyond the secret key.
  • No special environment variables or n8n configurations are needed besides setting up the webhook URL in WPForms.

Troubleshooting

  • Common issues:

    • Invalid or missing secret key will cause request validation to fail, preventing the workflow from triggering.
    • Incorrect webhook URL configuration in WPForms may result in no triggers firing.
    • Clock skew greater than the allowed Timestamp Skew value can cause validation errors.

  • Error messages:

    • Validation errors typically indicate problems with the secret key or timestamp mismatch. To resolve, ensure the secret key matches exactly and consider increasing the Timestamp Skew if server/client clocks differ significantly.
    • If no data is received, verify that WPForms is correctly configured to send webhook requests to the node’s webhook URL.

Links and References

Discussion