> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Form Event-Based Trigger

> Use web form submissions as triggers to start automated workflows in Blink.

The Web Form Event-Based Trigger serves as a powerful tool for collecting information directly from end users through a static URL hosting a Web Form. This trigger can then propel workflows forward based on the responses provided. The trigger enables workflows to be initiated automatically when a user submits a response to a Web Form, offering seamless automated workflows based on form submissions. By using this feature, users can streamline their processes, ensuring that the right actions are taken at the right time without manual intervention.

***

## Supported Web Form Flow Types

The Web Form Event-Based Trigger is designed to support two distinct flow types

1. **Single Step**: Creates static and non-interactive web forms.
2. **New Interactive**: Creates a web form that can be used in an interactive web form session, initiated either by a previous web form step or a Web Form Trigger.

***

## Configure a Single Step Web Form Trigger

<Accordion title="Interactive Web Form Trigger- Use Case Example">
  ### Workflow Overview: Web Form Reset User Password

  **Purpose**: This workflow automates the process of resetting a user’s password in response to a Blink Web Form submission. It includes built-in safeguards to ensure that no action is taken without explicit user confirmation. Once confirmed, it generates a new password, updates the user’s credentials through Microsoft Entra ID, and communicates the result.

  <Frame>
    <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormTriggerWorkflow.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=973503e78600d250a94e36c887d39da3" width="1720" height="1076" data-path="img/Actions/WebFormTriggerWorkflow.png" />
  </Frame>

  ***

  ### Workflow Logic and Steps

  **Trigger**

  * **Type:** [Event-Based Trigger](/docs/workflows/building-workflows/triggers/event-based-triggers/event-based-triggers)
  * **Event:** Blink Web Form response
  * **Web form flow type**: [New Interactive](/docs/blink-platform/web-form/web-form#web-form-types)

  <Frame>
    <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormTriggerWorkflow3.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=58ec32723ed8ba42bc02289e93b7f70c" width="3440" height="2152" data-path="img/Actions/WebFormTriggerWorkflow3.png" />
  </Frame>

  The workflow is triggered when a user submits a specific Blink Web Form designed to request a password reset, like seen in the following video:

  <Frame>
    <video controls autoPlay muted zoom loop allowFullScreen className="w-full aspect-video" src="https://res.cloudinary.com/dsiyoh0ge/video/upload/v1745927103/WebFormTriggerExample_a02eqo.mp4" />
  </Frame>

  **Step 1: Confirmation**
  This step captures the user's response to a confirmation prompt within the web form (e.g., "Are you sure you want to reset the password?").

  **Step 2: Conditional Check**
  Evaluates the confirmation input:

  * If the user selected **"Confirm"**, the workflow proceeds with the password reset process.
  * If not, the workflow exits without taking any further action.

  **If Confirmed:**

  * **Step 3: Generate Random Password**: A secure, randomly generated password is created for the user. This will be used to update their credentials.
  * **Step 4: Resetting Password Now**: This step logs or communicates that the password reset process has started. This may involve sending a notification or writing a message to a log.
  * **Step 5: Reset User Password**: Uses the Microsoft Entra ID integration to reset the user's password to the one generated in Step 3. The user is identified using their Entra ID value collected earlier or from the form submission.
  * **Step 6: Web Form Status - Password Reset Done**: Provides feedback via the web form or notification that the password reset has been successfully completed.

  <Frame>
    <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormTriggerWorkflow1.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=835302e067144a947488a2d41a7b0489" width="1725" height="1076" data-path="img/Actions/WebFormTriggerWorkflow1.png" />
  </Frame>

  **If Not Confirmed:**

  * **Step 7: Else Condition**: Handles all cases where the user’s confirmation response is not "Confirm".
  * **Step 8: Abort**: The workflow stops, ensuring that no changes are made unless explicit confirmation was provided.

  <Frame>
    <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormTriggerWorkflow2.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=2fa87b06284f890e2da1831f129159c9" width="1721" height="1080" data-path="img/Actions/WebFormTriggerWorkflow2.png" />
  </Frame>

  ***
</Accordion>

<Steps>
  <Step title="Create a new workflow. Choose the Event-based Workflow trigger type">
    **Optional:** Configure the advanced settings if needed, then click **Create Workflow**. This will open the Workflow Editor.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/xnKigMZdVI45SQhn/img/Automations/EventBasedTrigger.gif?s=4384f5c79a967fd6b37f93d9459d66f4" width="1944" height="1080" data-path="img/Automations/EventBasedTrigger.gif" />
    </Frame>
  </Step>

  <Step title="Configure the Event-Based Workflow">
    In the *Trigger: Event-Based* section, click the *"Click to select an event"*.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/yRkQ-wRlnQIXwr-A/img/Actions/ConfigureTrigger.png?fit=max&auto=format&n=yRkQ-wRlnQIXwr-A&q=85&s=43d3ddf5163ad495d917efd0070649d9" width="3584" height="2058" data-path="img/Actions/ConfigureTrigger.png" />
    </Frame>
  </Step>

  <Step title="Select the 'Blink Web Form' trigger">
    Then choose the "Blink Web Form response" event and click **Apply** button to confirm.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormTrigger.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=93a8be315373a472f1dbe58e2803cbb1" width="1920" height="1080" data-path="img/Actions/WebFormTrigger.png" />
    </Frame>
  </Step>

  <Step title="Set the web form flow Type as ‘Single Step’">
    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/TriggerSingleStep.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=ff3c45f9e3d8e0e4018fd43217769f52" width="3456" height="1972" data-path="img/Actions/TriggerSingleStep.png" />
    </Frame>
  </Step>

  <Step title="Configure and Add Input Fields">
    Next, add input parameters and customize how they are displayed in the Webform

    * **Parameter Name**: The name given to the input parameter
    * **Parameter Type**: Select the appropriate [input type](/docs/workflows/building-workflows/triggers/on-demand-triggers/input-parameters#input-parameter-types) based on the expected data (for example, string, number, boolean).
    * **Optional:**

      * **Display Name**: The label shown to users for this input parameter.
      * **Required**: Enable this option to make the parameter mandatory. Disable it to allow the parameter to remain optional.
      * **Placeholder** *(available for relevant types)*: Optional sample text displayed inside the input field to guide users on the expected format (for example, a sample username or email address).
      * **Default Value**: The value automatically used if the user does not provide an input
      * **Instructions Text:**
        * **Tooltip**: Contextual text that appears on hover, offering additional explanation or clarification for the parameter.
        * **Helper Text**: Supporting text shown below the input field to guide the user on how to complete it correctly.
        * **Description**: The text shown to the user, either as a tooltip or as helper text, depending on the selected option.

          <Frame>
            <img src="https://mintcdn.com/blinkops-2/qkfhuXw8-dJ-DUAR/img/Actions/WebformResponses.png?fit=max&auto=format&n=qkfhuXw8-dJ-DUAR&q=85&s=f209c4fc238c292d780c449de94bdf29" width="1729" height="1084" data-path="img/Actions/WebformResponses.png" />
          </Frame>
  </Step>

  <Step title="Complete the additional fields:">
    * **URL Link**: Copy the link provided.

    * **Header**: Add a title for your web form.

    * **Use Custom Logo**: **(Optional)** Check the box to include a custom logo and provide the image URL.

    * **Description**: **(Optional)** Add a brief description.

    * **Button Text**: Enter the text you want displayed on the form’s submit button.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormParamsSingle.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=c397e1a5416d3797bbe635446ac1ddd1" width="3456" height="1984" data-path="img/Actions/WebFormParamsSingle.png" />
    </Frame>
  </Step>

  <Step title="In Advanced Settings you can choose who can access and interact with the Web Form:">
    ***Access Control Hierarchy:***

    * **Anyone in this tenant:** Anyone signed into the tenant can access the form. This is the default option.
    * **Anyone in this workspace:** Only signed-in members of the specific workspace where the web-form was created, can access the form.
    * **Anyone with link (public):** Anyone with the form URL link can access and interact with it.
    * **Anyone in the organization (SSO):** Blink users can access and interact with the form only via their organization’s SSO.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/yRkQ-wRlnQIXwr-A/img/Actions/AccessControlWFT.png?fit=max&auto=format&n=yRkQ-wRlnQIXwr-A&q=85&s=243c00fc64f096606470228c203d1cbc" width="3454" height="1978" data-path="img/Actions/AccessControlWFT.png" />
    </Frame>
  </Step>

  <Step title="Check the box if you would like to include the metadata in the Web Form response.">
    <Frame>
      <img src="https://mintcdn.com/blinkops-2/3_6WnkGGmnkZFzEe/img/Actions/MetadataWFT.png?fit=max&auto=format&n=3_6WnkGGmnkZFzEe&q=85&s=02c52cd07a0e93256e0e4c213a51526e" width="3419" height="1962" data-path="img/Actions/MetadataWFT.png" />
    </Frame>
  </Step>

  <Step title="Click the 'Apply' button to save your changes">
    Continue building your workflow. No further web form related step is mandatory.
  </Step>
</Steps>

***

## Configure an Interactive Web Form Trigger

<Steps>
  <Step title="Change the web form's flow type to 'New interactive'">
    Follow steps 1-7 as outlined in the [Configure a Single Step Web Form Trigger](#configure-a-single-step-web-form-trigger) guide from the previous section. However, in step two, ensure that the *Web Form Flow Type* is set to 'New interactive'.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/TriggerInteractiveStep.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=c7edc076cb1b2c156190c2d5f2503268" width="3448" height="1966" data-path="img/Actions/TriggerInteractiveStep.png" />
    </Frame>
  </Step>

  <Step title="Click the 'Apply' button to save your changes and continue building your workflow.">
    As part of the Workflow steps, configure **at least one more** interactive web form:

    1. Add the ‘New Web Form’ action to the step

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/TriggerNewWebForm.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=19df1b99793df8bc9ccf9ea783ecb50d" width="3452" height="1980" data-path="img/Actions/TriggerNewWebForm.png" />
    </Frame>

    2. Set *Web Form Flow Type* as ‘Existing Interactive’

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/TriggerExistingFlow.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=0a17dc9876595722d7e72365ee035973" width="3449" height="1976" data-path="img/Actions/TriggerExistingFlow.png" />
    </Frame>

    3. To force the step wait for the web form response, select the ‘Wait for web form response’ checkbox. Alternatively, you can add a subsequent [wait](/docs/workflows/building-workflows/actions/basic-actions/flow-control-actions#wait) action to a step, to wait for the web form response.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/TriggerWaitForResponse.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=1a8e768a53559b2bbad4ba9204ad2bab" width="3447" height="1966" data-path="img/Actions/TriggerWaitForResponse.png" />
    </Frame>
  </Step>

  <Step title="Processing Status Notification">
    Once a web form is submitted, a default ‘processing’ status is displayed to indicate that the input is being handled. If the workflow includes additional forms, the next form in the sequence will be shown. Upon submission of the final form, a default success or failure message is displayed based on the outcome of the workflow's response processing.

    <Note>You can customize the status response. Visit the ["Set Interactive Web Form Status" Section](#set-interactive-web-form-status) to learn how.</Note>

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/TriggerLoadingResponse.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=44558849e2452089bc138898ab4c691a" width="3435" height="1978" data-path="img/Actions/TriggerLoadingResponse.png" />
    </Frame>
  </Step>
</Steps>

***

## Testing Web Form Trigger

In the following use case example, we are testing a Web Form Trigger with a single step web form flow type.

<Steps>
  <Step title="Test your newly created Web Form Event-Based Trigger">
    Click the "Test Parameters" button.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormParamsInteractive.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=8b9378e8424ae7aca408e9bdb5b83910" width="3442" height="1972" data-path="img/Actions/WebFormParamsInteractive.png" />
    </Frame>
  </Step>

  <Step title="A popup window will appear">
    Click the "Test Web Form" button in the bottom-left corner.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/deay2AiePWJDKGEh/img/Actions/TestWebForm.png?fit=max&auto=format&n=deay2AiePWJDKGEh&q=85&s=5ea4ddd2030edf765ab543ac5aba6d34" width="3572" height="2056" data-path="img/Actions/TestWebForm.png" />
    </Frame>
  </Step>

  <Step title="Fill out the form">
    A new browser tab will open, displaying the Web Form you just created. Fill out the form and click Submit.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/XMlZfP6f_keDWota/img/Actions/WebFormDetails.png?fit=max&auto=format&n=XMlZfP6f_keDWota&q=85&s=ff12ee737a3eddb659b0cbc322af1e17" width="3446" height="1976" data-path="img/Actions/WebFormDetails.png" />
    </Frame>
  </Step>

  <Step title="Review results'">
    Return to the Test Parameters popup, where you can review the information you entered in the form.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/3_6WnkGGmnkZFzEe/img/Actions/ResultWebForms.png?fit=max&auto=format&n=3_6WnkGGmnkZFzEe&q=85&s=27371b1b73e3acada30fe92a31503f39" width="3446" height="1978" data-path="img/Actions/ResultWebForms.png" />
    </Frame>
  </Step>
</Steps>
