Skip to content

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.

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 seconds

When 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/json

Always JSON.

User-Agentstring
Seaforms-Webhooks/1.0 (+https://developer.seaforms.io/webhooks/)

Any custom headers you set on the connection are added.

POST your-endpoint
{
"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"
}
}
typestring

submission.created.

apiVersionstring

The 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 3339

When the submission was stored, in UTC.

testboolean

true for 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.answersobject

The answers, keyed by each question’s key. Only what the visitor could see and answered is here. npx seaforms pull writes a type for it. Each type’s value is on Questions.

data.labelsobject

The 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 | null

The price breakdown, worked out on our server, when the form has prices.

data.tagsstring[]

Tags the form’s settings added.

data.metaobject

Where it came from: page (url, title, referrer), timezone, locale, attribution (UTM tags, gclid, fbclid, msclkid), mode, and country and userAgent when known.

data.filesobject[]

Uploaded files, each { id, field, name, size, type, url }. url is an unguessable link that stays valid until the submission is deleted.

data.inboxstring

A link to this submission in the app.

Was this helpful?

Your answer goes straight to the person who wrote it.

Thanks. We read every note and update the article.

Thanks, that helps us keep these useful.

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