Retries and repeats
A delivery has worked when your endpoint answers any 2xx within 15 seconds. Anything else is tried again.
When it’s tried again
Section titled “When it’s tried again”After a failure, we wait 1 minute, 5 minutes, 30 minutes, 2 hours, 12 hours and 24 hours, each measured from the attempt before. That’s six more tries over about a day and a half. Each is signed afresh, so a late one still passes your time check.
- A timeout, a connection error or any status that isn’t
2xxcounts as a failure. - A redirect counts as a failure too. We don’t follow it, so a moved endpoint shows up in your log instead of quietly sending data somewhere else.
410 Gonestops the retries for that delivery, and marks the connection as failing.
After the last try the delivery is marked failed, and the workspace’s owners and admins are emailed, at most once a day per form.
See what happened
Section titled “See what happened”In the app, open the submission in Submissions. Sent to shows whether each delivery went, with Try again on one that failed. The API has the same: deliveries.
When a connection keeps failing
Section titled “When a connection keeps failing”If every delivery to a webhook has failed for 5 days, the connection is paused and the owners are emailed. Its submissions wait: they’re held, not dropped. Fix your end, then choose Turn back on in Settings, then Connections, and they’re all sent.
The same event twice
Section titled “The same event twice”Retries mean an event can arrive more than once, for instance when your endpoint did the work but timed out before answering. So make your handler safe to run twice:
webhook-idis the same on every automatic retry of one delivery. Drop one you’ve seen.data.submissionis the same however the event arrived, including a manual resend, which gets a newwebhook-id. Key anything that must happen once on it.
// Insert first: a repeat hits the unique key and does nothing.const { changes } = await db .prepare("INSERT OR IGNORE INTO leads (submission, email) VALUES (?, ?)") .bind(event.data.submission, event.data.answers.email) .run();if (changes) await sendToSales(event.data);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