Form workflow nodes
Use TaskJuice Forms to start workflows from submissions or pause workflows until someone submits a response.
Forms provide two workflow nodes:
| Node | Type | Use it when |
|---|---|---|
| Form Submission | Trigger | A workflow should start when someone submits a published TaskJuice form. |
| Display Form | Action | A running workflow should pause, send or expose a form, and resume after the recipient submits it. |
Both nodes use forms created in the Forms area. Publish the form before publishing a workflow that references it.
Build the form first
Create the form in Forms, add fields, configure required fields and page flow, then publish it.
Publishing creates the stable schema used by workflow output mapping. If you later change and republish the form, new workflow publishes use the latest schema while already compiled workflow versions keep the schema they were published with.
Form Submission trigger
Use this trigger when an external user or internal teammate submits a TaskJuice form and that submission should start a workflow.
Open the workflow editor
Open the workflow that should receive form submissions.
Choose the trigger
Select the trigger slot, choose Forms, then select Form Submission.
Pick a published form
Choose the form whose submissions should start the workflow.
Copy the form URL
Use the Share section when you need to distribute the public form link.
Publish the workflow
Publish after every referenced form and required node field validates.
Trigger output
The trigger output uses the published form schema:
| Field | Description |
|---|---|
submissionId | Unique ID for the submitted response. |
submittedAt | Submission timestamp. |
fields | Submitted form values keyed by the form field keys. |
Downstream nodes can reference those values in expressions and mappings.
Display Form action
Use this action when the workflow needs human input after it has already started. The workflow pauses, creates a resume URL for the selected form, and continues when the form is submitted.
Add an action node
Add an Action node after an existing trigger or step.Choose Forms
Choose Forms from the app list.Select Display Form
Select Display Form.Pick the form
Choose the published form to display while the workflow waits.Publish and test
Test with a real form response before distributing the workflow broadly.
Action output
| Field | Description |
|---|---|
resumeUrl | URL used to complete the form and resume the paused workflow. |
expiresAt | Expiration timestamp for the form resume window. |
Publish requirements
A workflow publish is blocked when a referenced form is missing, still in draft, archived, or belongs to a different tenant. Fix the form selection or publish the form, then publish the workflow again.
Operational notes
- Keep form field keys stable when downstream workflow steps reference them.
- Prefer a new field key over renaming a key that existing workflows already use.
- Test the workflow with a real form submission before distributing the public link.
- Review submissions from the form's Submissions page when troubleshooting.