#111025Add webhook finisher to EXT:form
Description
Sending form submissions to external systems (n8n, CRM, ticketing, marketing automation) currently needs a custom finisher.
TYPO3 already ships EXT:webhooks with signed, admin-managed outgoing webhooks, but EXT:form offers no trigger for it.
- New webhook trigger “Form submitted” (identifier typo3/form-submitted), provided by EXT:form as TYPO3\CMS\Form\Message\FormSubmittedMessage. Like the redirect trigger of EXT:redirects it only uses the attribute and interfaces from EXT:core, so EXT:form does not depend on EXT:webhooks.
- New finisher “Webhook” (WebhookFinisher), available in the form editor. Its option “webhooks” takes a list of sys_webhook identifiers (UUIDs). On submit the finisher builds the payload and dispatches the message to the message bus, targeting exactly these webhooks (depends on targeted webhook messages, see related issue).
URL, secret, HTTP method, headers and SSL verification remain in the sys_webhook record, which only administrators manage. Editors can choose which webhook a form uses, but cannot define target URLs.
Payload
A fixed JSON structure:- submissionId (UUID)
- submittedAt
- form: identifier (as declared, without the content element suffix), persistenceIdentifier, label
- context: site identifier, language, page uid, content element uid
- values: keyed by element identifier, each with type, label and value
Never included: password fields, honeypot, disabled elements and elements without a value.
File and image uploads are a list of name, MIME type and size. The download URL (FAL public URL; the signed dumpFile URL for non-public
storages) is only added when the form has no DeleteUploads finisher, since the files would otherwise be gone before the receiver fetches them.
Behaviour
- Fire-and-forget: the response of the endpoint does not influence the form submission. Delivery errors are logged by EXT:webhooks.
- Exceptions while dispatching are logged; the submission always completes.
- Without EXT:webhooks installed the finisher does nothing.
Out of scope
Configurable payload / field mapping, feedback from the endpoint into the form.
Reviews 3
Related issues 1
History 26
-
Josua Vogel changed Related to #111024 <span data-processor="relativetime" data-value="2026-10-12T06:18:00+00:00" > 10/12/26, 06:18 </span>
-
Gerrit Code Review pushed patch set 1 for main to change 97596 status
NewUnder Review <span data-processor="relativetime" data-value="2026-11-13T07:19:28+00:00" > 11/13/26, 07:19 </span> -
Gerrit Code Review pushed patch set 2 for main to change 97596 <span data-processor="relativetime" data-value="2026-11-13T07:45:42+00:00" > 11/13/26, 07:45 </span>
-
Gerrit Code Review pushed patch set 3 for main to change 97596 <span data-processor="relativetime" data-value="2026-11-13T08:03:18+00:00" > 11/13/26, 08:03 </span>
-
Gerrit Code Review pushed patch set 4 for main to change 97596 <span data-processor="relativetime" data-value="2026-11-13T08:12:21+00:00" > 11/13/26, 08:12 </span>
https://review.typo3.org/c/Packages/TYPO3.CMS/+/94128 was a poc I did