Webhooks integration
Overview
Send every form response or submission straight to a compatible web app URL.
What you need
- An active Feathery account and form
- A URL to send form data to
What is a webhook?
In general terms, a webhook is simply a notification sent over the web, which is triggered automatically whenever a specific event occurs.
In this case, the event is a new Feathery form submission. Whenever a new Feathery form submission comes in, a notification containing the response data is immediately sent to your provided end destination.
How to set up
Note: you can generate a free test URL to collect test submissions at: https://webhook.site/
Open the Integrations tab in your Feathery form and click on the Webhooks integration.
.svg)
Toggle on the integration and add your destination URL to POST to. If you also specify a test URL, it will be POSTed to if you're filling out the test version of the Feathery form. Specify custom headers to be included as well as when you'd like the webhook to run. The webhook can run either when the entire form is completed or whenever data is received (step submission, integration connections, etc.). Then, click Save.
.svg)
If your webhook is successfully connected, you should see a successful POST with user data when filling out the form. The payload will include the following entries:
- A key-value mapping of the field values that were submitted in the current webhook event.
- feathery_user_ id: The user ID corresponding to the current form submission.
- feathery_form_ name: The name of the current form
- feathery_form_id: The ID of the current form
- feathery_step_ id: If the webhook trigger is "any data is received", step submissions will trigger webhook events that contain the ID of the step that was submitted.
- field_details: Metadata details of the fields whose values are included in the current webhook event. It's in the format [{field: string; internal_id: string; type: string; label: string;}] where field is the field ID, internal_id is a static internal identifier for the field, type is the field type (e.g. text_field, button_group) and label is the user-facing field description, if it is set.
Event Types
When a form is submitted.
Whenever data is received, such as:
- When a new form step is submitted
- When an integration is connected (e.g. Plaid)
- When a value is manually set within a codebase
.svg)
