The event
Each delivery is an HTTP POST with a JSON body. There’s one event type today: submission.created.
It’s sent when a submission is complete, including one that was caught as spam or marked spam and then marked Not spam. Each webhook gets each submission once, not counting retries.
Headers
Section titled “Headers”webhook-idevt_…The event’s ID. It’s the same on every automatic retry of one delivery, and new if someone resends it by hand.
webhook-timestampUnix secondsWhen this attempt was sent. Each retry is signed again, so one sent a day later is still fresh.
webhook-signaturev1,<base64>The signature, or two separated by a space while the secret is being changed. See Verify the signature.
Content-Typeapplication/jsonAlways JSON.
User-AgentstringSeaforms-Webhooks/1.0 (+https://developer.seaforms.io/webhooks/)
Any custom headers you set on the connection are added.
The body
Section titled “The body”{ "type": "submission.created", "apiVersion": "2026-11-16", "id": "evt_01JC8H2M6R5W3K9D2T4Y7B1Q8N", "createdAt": "2026-11-12T09:41:07.000Z", "test": false, "data": { "submission": "sub_01JC8H2K4M7P9X3V5B8N1Q6W2T", "form": { "id": "frm_7f3kq2m4xa", "name": "contact", "revision": 3 }, "path": [ "get-in-touch" ], "answers": { "name": "Maya Chen", "email": "maya@northwind.co", "topic": "sales", "message": "Could you quote for a new site by March?" }, "labels": { "topic": "Sales" }, "pricing": null, "tags": [], "meta": { "page": { "url": "https://northwind.co/contact", "title": "Contact · Northwind", "referrer": "https://www.google.com/" }, "timezone": "Australia/Adelaide", "locale": "en-AU", "attribution": { "utm_source": "newsletter" }, "mode": "steps", "country": "AU", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.1 Safari/605.1.15" }, "files": [], "inbox": "https://app.seaforms.io/s/sub_01JC8H2K4M7P9X3V5B8N1Q6W2T" }}typestringsubmission.created.apiVersionstringThe date of this payload’s format,
2026-11-16. Fields are only ever added to it.idevt_…The event’s ID, the same as
webhook-id.createdAtRFC 3339When the submission was stored, in UTC.
testbooleantruefor a test: one sent with a dev token, or by Send a test.data.submissionsub_…The submission’s ID. Key anything your code does on this: it’s the same however many times the event arrives.
data.form{ id, name, revision }Which form, by its ID and its name in the app, and the published revision the visitor filled in.
data.pathstring[]The IDs of the steps the visitor went through.
data.answersobjectThe answers, keyed by each question’s key. Only what the visitor could see and answered is here.
npx seaforms pullwrites a type for it. Each type’s value is on Questions.data.labelsobjectThe display text for answers that have one: an option’s label, a formatted date or amount. Use it when you show an answer to a person.
data.pricingobject | nullThe price breakdown, worked out on our server, when the form has prices.
data.tagsstring[]Tags the form’s settings added.
data.metaobjectWhere it came from:
page(url,title,referrer),timezone,locale,attribution(UTM tags,gclid,fbclid,msclkid),mode, andcountryanduserAgentwhen known.data.filesobject[]Uploaded files, each
{ id, field, name, size, type, url }.urlis an unguessable link that stays valid until the submission is deleted.data.inboxstringA link to this submission in the app.
ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks