/forms/{formId}/webhooks

post

https://www.formstack.com/api/v2025/forms/{formId}/webhooks

Create a new webhook for a form

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

formId

integer

required

The ID of the form

Body Params

Base Webhook Input properties

name

string

Name of the webhook

url

uri

URL to send the webhook data to

contentType

string | null

enum

Defaults to urlencoded

Content type of the webhook data (urlencoded or json)

Allowed:

fileTransferType

string | null

enum

Defaults to downloadLink

Method for transferring file data in webhook payloads

Allowed:

postDataFieldKeys

string | null

enum

Defaults to field_names

Format of field keys in POST data

Allowed:

sharedSecret

string | null

Shared secret for the webhook

hmacSecret

string | null

HMAC secret used for signing webhook payload data

customHmacHeader

string | null

Custom HMAC header name

errorEmails

string | null

Comma-separated email addresses to notify when webhook delivery fails

includeFieldType

boolean | null

Defaults to false

Whether to include field type information in the webhook data

includeSubfieldNames

boolean | null

Defaults to true

Whether to include subfield names in the webhook data

standardizeValues

boolean | null

Defaults to false

Whether to standardize field values in the webhook data for consistency

customerApprovedPciCompliant

boolean | null

Defaults to false

Whether the webhook has been approved for PCI compliance

logic

Logic conditions for when to execute the webhook

Responses

400

Invalid request

403

Forbidden

404

Form not found

500

Failed to create webhook

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Webhook created