Issue Feature Under Review

#111025Add webhook finisher to EXT:form

Josua Vogel 10/12/26, 06:17 updated 11/13/26, 08:12

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.

  1. 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.
  2. 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

History 26