Webhook Events

Formtorch currently delivers one event type.

submission.created

Fires when a new non-spam submission is received.

Payload


{
  "type": "submission.created",
  "data": {
    "formId": "a1b2c3d4e5",
    "submissionId": "x9y8z7w6v5",
    "fields": {
      "name": "Alex",
      "email": "alex@example.com",
      "message": "Hello there"
    },
    "submittedAt": "2025-03-15T14:30:00.000Z",
    "isSpam": false,
    "spamScore": 0
  }
}

Payload fields

Field	Type	Description
`type`	string	Always `"submission.created"`
`data.formId`	string	ID of the form that received the submission
`data.submissionId`	string	Unique submission ID
`data.fields`	object	Key-value pairs of submitted fields
`data.submittedAt`	string	ISO 8601 timestamp of submission
`data.isSpam`	boolean	Whether TorchWarden flagged this as spam
`data.spamScore`	integer	TorchWarden spam score

Notes on fields

Reserved fields (_redirect, _honeypot, _formName, _test) are stripped before delivery
File upload fields are not included in the webhook payload; access files via the dashboard or API
Field values are always strings

Planned events

The following events are planned for a future release:

submission.spam_updated: fired when a submission’s spam status is manually changed
form.created: fired when a form is created via the API
form.deleted: fired when a form is deleted