---
title: Form Actions
description: "Learn how to use Form Actions in APIANT — dynamically create forms, pre-populate fields, pause automations with 'await form submission,' and continue workflows when submissions are received.\""
---

[Skip to content](https://help.apiant.com/form-actions#main-content)

English

Show submenu for translations

![apiant-logo-forum.png\]](https://help.apiant.com/hs-fs/hubfs/apiant-logo-forum.png?height=40&name=apiant-logo-forum.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to apiant.com

 Go to apiant.com

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.apiant.com/?hsLang=en)
2. [AutomationEditor](https://help.apiant.com/automationeditor?hsLang=en)
3. [Building Automations](https://help.apiant.com/automationeditor?hsLang=en#building-automations)

# Form Actions

## Learn how to use Form Actions in APIANT — dynamically create forms, pre-populate fields, pause automations with 'await form submission,' and continue workflows when submissions are received."

Form actions are where the form is created as an action, which can optionally include data-mapped values to populate the form design with dynamic content. The output from a form action is the unique URL to the form, which is then typically sent to someone via email or some other mechanism. An "await form submission" action pauses the automation and awaits the form submission. When the form is submitted, the automation wakes up, the "await form submission" action emits the submitted form field values, and the automation continues its processing.

The "create a form" action is found under System Utilities within the Human Interaction app:

![Create a Form Action](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/XVdqleI7Tcqm0lKeuVGJe_image.png?format=webp)

Create a Form Action

 

Click the Edit button to open the form designer:

![Edit Form](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/pQRgje9o1yKMiRGfPiz8g_image.png?format=webp)

Edit Form

 

The drag-drop form designer lets you design your form and preview it.

[Form Designer](https://help.apiant.com/form-designer?hsLang=en)

The "create a form" action emits the URL to the form, which is typically sent to someone via another action like email:

![Form URL](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/EMQGu5tMRgaQKD490ToFZ_image.png?format=webp)

Form URL

 

The Human Interaction app under System Utilities includes "await form submission" actions that pause the automation until the form is submitted:

![Await Form Submission](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/jwWei1FprrZStCDbjDhwC_image.png?format=webp)

Await Form Submission

 

The "await form submission with timeout" action is a variation that will emit an empty form response if no submission is received within the specified amount of time.

The "await form submission" action is automatically associated to the closest preceding "create a form" action. It is ok to place other actions in between the "create a form" action and the "await form submission" action (and generally it is required in order to send the form URL to someone), but generally you want to keep these two actions close to each other so it is readily apparent that these two actions are associated with each other.

After adding the "await form submission" action, the form's fields must first be fetched:

![Fetch Form Fields](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/fHcmWUW9d25469mkPfTaa_image.png?format=webp)

Fetch Form Fields

 

#### Dynamic Inputs

The form's data fields can optionally be pre-populated with information, including dynamic data-mapped values:

![Data-mapped Form Inputs](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/LiiiR957Zv5Oobm2s2yej_image.png?format=webp)

Data-mapped Form Inputs

 

The input field names come from the UI elements within the form. For example, in the previous example the "first\_name" field comes from this text entry field's name in the design:

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/OAia_MjcNyzFHSeQW5VU5_image.png?format=webp)

 

If no input values are entered for the form's fields, then the default values in the form's design will be used when the form is opened.

 

 

If the UI element is a dropdown control and an array of values is mapped to it, the dropdown will display the array as the selectable choices in its pick list.

To send array data into a form for display, see [Array Data](https://help.apiant.com/array-data?hsLang=en).

 

 

NOTE: any time the form design is edited, the corresponding "await form submission" action must be opened and the Refresh Fields button must be clicked and the action saved in order for the revised form fields to be processed!

![Refresh Fields](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/vfMy50DT0BfvC4sMElCpC_image.png?format=webp)

Refresh Fields

 

When the form is submitted, the automation wakes up and the "await form submission" action will emit the form field values, which can be mapped to other actions:

![Form Output Fields](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/8Zy52FE1CPv1-TKGLl4iN_image.png?format=webp)

Form Output Fields

 

An automation may contain multiple forms, allowing complex workflows to be created where different forms with varying dynamic content are generated based upon previously received form submissions:

 

![Form Logic](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/Q_S_72Pll5KgKUBr7CGfw_image.png?format=webp)

Form Logic

 

 

- [ZoomConnect](https://help.apiant.com/zoomconnect?hsLang=en)
- [ShopConnect](https://help.apiant.com/shopconnect?hsLang=en)
- [AppConnect](https://help.apiant.com/appconnect?hsLang=en#main-content)

    - [AppConnectPrebuiltConnectors](https://help.apiant.com/appconnect?hsLang=en#appconnectprebuiltconnectors)
- [CalendarConnect](https://help.apiant.com/calendarconnect?hsLang=en)
- [CRMConnect](https://help.apiant.com/crmconnect?hsLang=en#main-content)

    - [Mindbody to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#mindbody-to-hubspot)
    - [Cliniko to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#cliniko-to-hubspot)
    - [Cliniko to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#cliniko-to-activecampaign)
    - [DonorPerfect to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#donorperfect-to-hubspot)
    - [DonorPerfect to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#donorperfect-to-activecampaign)
    - [Mindbody to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#mindbody-to-activecampaign)
- [MailConnect](https://help.apiant.com/mailconnect?hsLang=en)
- [AutomationEditor](https://help.apiant.com/automationeditor?hsLang=en#main-content)

    - [KeyConcepts](https://help.apiant.com/automationeditor?hsLang=en#keyconcepts)
    - [AccountManagement](https://help.apiant.com/automationeditor?hsLang=en#accountmanagement)
    - [ManagingAutomations](https://help.apiant.com/automationeditor?hsLang=en#managingautomations)
    - [App Connections](https://help.apiant.com/automationeditor?hsLang=en#app-connections)
    - [Building Automations](https://help.apiant.com/automationeditor?hsLang=en#building-automations)
- [APIANTforBuilders](https://help.apiant.com/apiantforbuilders?hsLang=en)
- [APIANTInline](https://help.apiant.com/apiantinline?hsLang=en)
- [WhatisAPIANT?](https://help.apiant.com/whatisapiant?hsLang=en)
- [ContactAPIANTsupport](https://help.apiant.com/contactapiantsupport?hsLang=en)

[![APIANT](https://help.apiant.com/hubfs/APIANT_LOGO-2.svg "APIANT")](http://apiant.com)

apiant.com Help Center

Copyright © 2026, APIANT