Create Webhook
formstack.create_webhook
ActionBusiness appsconnection required
Calls the Formstack API with the connection's credentials.
Add a webhook so Formstack posts every new submission on a form to a URL, which is how a Mantle webhook trigger receives them.
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
7 fields, 3 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 |
name A name for the webhook, shown in the Formstack form settings. | string | Yes | — | — | Mantle workflow trigger |
url The endpoint Formstack posts each new submission to. | string | Yes | — | url format | https://hooks.example.com/formstack |
content_type How the payload is encoded when Formstack posts it. | string | No | urlencoded | one of "urlencoded", "json" | — |
post_data_field_keys Which naming Formstack uses for the field keys in the payload. | string | No | field_names | one of "field_names", "field_ids", "api_friendly_field_names", "internal_labels", "internal_labels_api_friendly" | — |
file_transfer_type How an uploaded file reaches the receiver: a link, a signed URL, or the file inline as base64. | string | No | downloadLink | one of "downloadLink", "signedUrl", "base64encode" | — |
error_emails Comma-separated addresses Formstack notifies when a delivery fails. | string | No | — | — | ops@example.com |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"content_type": "urlencoded",
"error_emails": "ops@example.com",
"file_transfer_type": "downloadLink",
"form_id": "2721234",
"name": "Mantle workflow trigger",
"post_data_field_keys": "field_names",
"url": "https://hooks.example.com/formstack"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id The numeric id of the new webhook. | number | — |
formId The form the webhook was added to. | number | — |
name The webhook's name. | string | — |
url The endpoint Formstack will post to. | string | — |
contentType The payload encoding Formstack recorded. | string | — |
postDataFieldKeys The field-key naming Formstack recorded. | string | — |
fileTransferType How uploaded files will be delivered. | string | — |
{
"contentType": "",
"fileTransferType": "",
"formId": 0,
"id": 0,
"name": "",
"postDataFieldKeys": "",
"url": ""
}See Create Webhook 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.