List Submissions
formstack.list_submissions
ActionBusiness appsconnection required
Calls the Formstack API with the connection's credentials.
List one form's submissions, filtered by keyword or date range.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Formstack
- Secret shape
- the Personal Access Token, or {"api_key": "fs_pat_…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
9 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
form_id The numeric id of the Formstack form to act on. | string | Yes | — | — | 2721234 |
keyword Only return submissions whose field values contain this text. | string | No | — | — | — |
min_time Only return submissions at or after this date, as YYYY-MM-DD or YYYY-MM-DD HH:MM:SS in US Eastern time. | string | No | — | — | 2026-01-01 |
max_time Only return submissions at or before this date, as YYYY-MM-DD or YYYY-MM-DD HH:MM:SS in US Eastern time. | string | No | — | — | 2026-01-31 23:59:59 |
include_data Include each submission's field values, not just its metadata. | boolean | No | false | — | — |
data_format Shape of the field values when they are included: the legacy map keyed by field id, or the standardized array. | string | No | legacy | one of "legacy", "standardized" | — |
order Sort direction applied to the returned page. | string | No | ASC | one of "ASC", "DESC" | — |
page_number Which page of results to return; the first page is 1. | number | No | — | ≥ 1 | — |
page_size How many records to return per page; Formstack allows 10 to 500. | number | No | 50 | 10–500 | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"data_format": "legacy",
"form_id": "2721234",
"include_data": false,
"max_time": "2026-01-31 23:59:59",
"min_time": "2026-01-01",
"order": "ASC",
"page_size": 50
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
submissions One entry per submission on this page. | array | — |
count How many records this page carried. | number | — |
page Formstack's pagination block for this response. | object | — |
page_number The page number Formstack returned. | number | — |
total_pages How many pages exist at this page size. | number | — |
total_elements How many records match in total. | number | — |
form_id The form the submissions were read from. | string | — |
{
"count": 0,
"form_id": "",
"page": {},
"page_number": 0,
"submissions": [],
"total_elements": 0,
"total_pages": 0
}See List Submissions run in a workflow.
In a technical demo we add the Formstack connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.