Webhooks
Webhooks allow you to automatically notify other software systems whenever something changes in Formtastic – for example when a form is sent or assigned to a team member. This lets you push Formtastic data in real time to your own systems, automation tools like Make or Zapier, or custom-built applications.
Webhooks are configured per form template. As soon as an event occurs, Formtastic automatically sends the form data as JSON to a URL of your choice.
Setting up a webhook
Open your form template in the form designer and switch to Webhooks in the side menu. Create a new webhook with the following fields:
Name: An internal label for this webhook.
URL: The address of the receiving endpoint Formtastic should send data to (must be HTTPS).
Comment (optional): An internal note about the intended use.
Secret: Generated automatically. Store it in your receiving system so you can verify that incoming requests genuinely come from Formtastic.
A webhook is active immediately after creation. It can be deactivated at any time without being deleted.
When is a webhook triggered?
A webhook fires whenever a submission changes its status. The possible states are:
- inbox – Newly received, not yet picked up
- in_work – Being edited by an assigned team member
- sent_assigned – Sent to a specific person
- sent_saved – Sent and saved
- removed – Deleted
Viewing and debugging deliveries
Every webhook delivery is logged in Formtastic. On the webhook detail page you can see the full request payload that was sent, the HTTP response code, and the status and number of attempts made. Failed deliveries are retried automatically.
Technical documentation for developers
The full technical reference – including payload format, field descriptions, authentication, retry logic and best practices – is available in the developer documentation: