Skip to content

Retries and repeats

A delivery has worked when your endpoint answers any 2xx within 15 seconds. Anything else is 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 2xx counts 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 Gone stops 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.

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.

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.

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-id is the same on every automatic retry of one delivery. Drop one you’ve seen.
  • data.submission is the same however the event arrived, including a manual resend, which gets a new webhook-id. Key anything that must happen once on it.
webhook-handler.ts
// 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);
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