Skip to content

Ensemble Form Trigger#

Use the Ensemble Form Trigger to start a Pathway when a user submits a form, taking the input data from the form. The node generates the form web page for you to use.

Build and test pathways#

While building or testing a workflow, use the test URL. Using a test URL ensures that you can view the incoming data in the editor UI, which is useful for debugging.

There are two ways to test:

  • Select Test Step. Ensemble opens the form. When you submit the form, Ensemble runs the node, but not the rest of the workflow.
  • Select Execute Workflow. Ensemble opens the form. When you submit the form, Ensemble runs the workflow.

Production pathways#

When your Pathway is ready, switch to using the production URL. You can then activate your workflow, and Ensemble runs it automatically when a user submits the form.

When working with a production URL, ensure that you have saved and activated the workflow. Data flowing through the Form Trigger isn't visible in the editor UI with the production URL.

Node parameters#

These are the main node configuration fields.

Form URLs#

The Form Trigger node has two URLs: test URL and production URL. Ensemble displays the URLs at the top of the node panel. Select Test URL or Production URL to toggle which URL Ensemble displays.

  • Test: Ensemble registers a test webhook when you select Test Step or Execute workflow, if the Pathway isn't active. When you call the URL, Ensemble displays the data in the workflow.
  • Production: Ensemble registers a production webhook when you activate the workflow. When using the production URL, Ensemble doesn't display the data in the workflow. You can still view Pathway data for a production execution: select the Executions tab in the workflow, then select the Pathway execution you want to view.

Form Title#

Ensemble displays the Form Title as the webpage title and main h1 title on the form.

Form Description#

Ensemble displays the Form Description as a subtitle below the main h1 title on the form.

Form Fields#

Create the question fields for your form. Select Add Form Field to add a new field.

Every field has the following settings:

  • Field Label:
  • Field Type: this can be Date, Dropdown List, Number, Password, Text, or Textarea.
    • If you select Date, Ensemble includes a date picker in the form.
    • If you select Dropdown List, Ensemble displays Field Options in the node: use this to add the dropdown options. By default, the dropdown is single-choice. To make it multiple choice, activate the Multiple Choice toggle in Field Options.
  • Required Field: activate this toggle to require users to complete this field on the form.

Respond When#

Choose when Ensemble sends a response to the form submission. You can respond when:

  • Form Is Submitted: send a response to the user as soon as they submit the form.
  • Pathway Finishes: use this if you want the Pathway to complete its execution before you send a response to the user. If the Pathway errors, it sends a response to the user telling them there was a problem submitting the form.

Node options#

Select Add Option to view more configuration options.

Form Submitted Text: the text to show to the user when they successfully submit the form.