> For the complete documentation index, see [llms.txt](https://software-help-docs.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-help-docs.gitbook.io/knowledge-base/software-guide/workflow-triggers/workflow-trigger-form-submitted.md).

# Workflow Trigger: Form Submitted

The *Form Submitted* Workflow Trigger will allow you to build a workflow that triggers whenever a form is submitted. Contacts who submit forms will be added to the workflow, allowing you to set up a variety of follow up actions once their form submission is completed. This article will outline how to set up a workflow using the *Form Submitted* Workflow Trigger.

* \*Note that this article will assume that you have customized forms already set up in your account. For an overview of how to create customized forms, see our article, “How To Customize a Form Or Survey”.

**Step 1:** Start a new workflow or edit an existing one

**Step 2:** Creating and Editing the Trigger

* Click “Add New Workflow Trigger”

{% embed url="<https://lh4.googleusercontent.com/uKrLmDiO3gL7u4zipa402Sa0e5BmBrJdZIN9-TeeOWRnCrcPeAs0bubeVvGOPfAMMDX9aspbLokdzRHUkK33UWjexA5notRSj5bvW7wGgSVSiqY1iHltWBrk-S-b6dGF79Hn3qbYX_y7n3mjZNQ0Yqo>" %}

* Select **Form Submitted** in the **Contact Actions** section of the Workflow Triggers Menu or use the search feature. Once selected, the Trigger setup menu will appear.
* (Optional) Change the display name of this trigger within the workflow builder under the **Workflow Trigger Name** textbox. Note that this won’t change any content or functionality related to this trigger or workflow other than the display name of the trigger which is only displayed within the workflow builder
* Press **+ Add filter** to bring up the **Filters** section. Here you will see some options to let you filter by specified customers or forms.
  * The **In Form** parameter allows you to only allow submissions of specified forms to trigger this workflow
  * **Custom Fields** allows you filter by contacts who have a specified custom field assigned to them so that only contacts who have the selected custom field can be added to this workflow
  * If you choose to leave the **Filters** section blank, then this workflow will be triggered by all Form Submissions from any contacts anywhere in your account.
* Press **Save Trigger** in the bottom right corner of the Trigger setup menu

{% embed url="<https://lh3.googleusercontent.com/nWX0nkdUz5zJxhZj82Zp6TS9JghFZXm6wYkWSZfwqfVIkqcimDcH9pC5eOwMRRlxAuuAxMCwDRQLMb8fpxD5O-sCHqicNLC_yZVr2Cl3Sf924vIuZMyxabRTwsrV_iY-WL64Yx_TNzZ7SfoWKBE7Xuk>" %}

**Step 3:** Set up applicable Workflow Action(s). We have multiple articles available to explain the setup of each of the Workflow Actions. Feel free to review our articles on these for more information on setting these up.

***Pro Tip:*** You can use any Workflow Actions to be triggered by the *Form Submitted* trigger or you can leave this workflow without any actions.

**Step 4:** Press **Save** in the top right corner of your browser to save the workflow

* If your Workflow is ready to be enabled, make sure the toggle switch under **Save** is set to **Publish**
* Be sure to test your Workflow to make sure it is set up correctly using the **Test Workflow** button next to the **Publish** toggle switch.
  * For an in-depth overview of Workflow Testing see our article, “Using the Testing Features in Workflows”

{% embed url="<https://lh5.googleusercontent.com/pNoQpWJxkBXkuQx-S2-YuFdDCMfQ4mVwwoOIN5WDhGm1MTazQ30jUj1e5OD-4c_MLgyfKLRwsVipmtYqS3hzyWgZy3veLeDQicnCehLeoN7_Ob-wrjdTXDWwoJmQ7vGZ0kL8UIOUWRm2-tT4BdZJDKA>" %}

Now your workflow is set up and ready to go with the *Form Submitted* Workflow Trigger.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-help-docs.gitbook.io/knowledge-base/software-guide/workflow-triggers/workflow-trigger-form-submitted.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.