Successful submissions
Distinguish durable acceptance from email delivery and reset the form safely.
A JSON success response is:
{
"success": true,
"submission_id": "8f2c1e7a4b6d8c0e5f3a2b1c9d8e7f60",
"message": "Your enquiry has been received."
}
HTTP 201 means the submission is stored and scheduled. HTTP 200 on a retry means the original submission was replayed.
Client behaviour
- Show an accessible success message.
- Reset the form fields.
- Reset the Turnstile widget and clear the token.
- Rotate the idempotency key.
- Optionally show the submission ID or request ID for support.
success.value = 'Your enquiry has been received.'
form.reset()
turnstile.reset()
idempotencyKey.value = crypto.randomUUID()
What not to say
Do not say “email delivered” or “we have received your message in our inbox” based only on the API response. Say “Your enquiry has been received” or “We’ll be in touch”.
Native HTML forms
The browser receives a 303 redirect to the configured success URL or the hosted thank-you page. Make that page accessible and confirm it does not depend on a session that the visitor does not have.