Skip to main content
For general webhook concepts like bubble-up behavior, payload visibility rules, and versioned snapshots, see Webhook Concepts.

Description

This event is triggered when a form instance is updated.

Integration Details

  • Subscription Key: form.form_instance.updated
  • Use Case: Track form revision history or detect changes to submitted data.
  • Related Events: form.form_instance.created

Trigger

  • Event Type: form_form_instance_updated
  • Source: Update of a record in the frm.form_instance table.
This is a versioned-snapshot event. The payload includes both old (previous state) and new (current state) at the root level because frm.form_instance has no history table. See Versioned-Snapshot Objects.

Payload Example

Payload Type Showcase

Field Notes

  • form_data is JSONB containing the actual submission values keyed by field UUID. Use form_fields to interpret the keys.
  • meta is JSONB with submission context (source, device, etc.).
  • structure on form_version is JSONB defining the form layout and field configuration.
  • The form_version → form join provides the parent form metadata (name, type, active status).