Troubleshooting delivery
Diagnose acceptance, CORS, Turnstile and email delivery problems.
Start by separating the three stages: request accepted, provider accepted, inbox delivered.
The request was not accepted
| Status | Check |
|---|---|
403 origin_not_allowed | The request origin must exactly match an allowed website origin. Server clients must send Origin. |
403 verification_failed | Turnstile token missing, expired, reused, wrong hostname/action, or honeypot filled. |
404 form_unavailable | The form, website or customer is disabled, or the public ID is wrong. |
409 idempotency_conflict | The same key was used with a different payload. Use a new key for changed content. |
413 payload_too_large | The body exceeds 64 KiB. |
415 unsupported_media_type | Files, nested objects or an unsupported content type were sent. |
422 validation_failed | A configured required field is missing or a field is not allowed. |
429 rate_limited | Wait for Retry-After. |
503 temporarily_unavailable | The form is not ready, Redis is unavailable, or Turnstile verification is down. |
The request was accepted but no email arrived
- Open the submission in the Postvia inbox.
- Check the delivery timeline and status.
- Review the safe error category on the delivery.
- Confirm the queue worker and scheduler are running.
- Resend manually if the delivery is permanently failed or exhausted.
- If the outcome is unknown, confirm the duplicate warning before resending.
CORS errors
A browser CORS error usually means the page origin is not allowlisted. Add the canonical origin, including the scheme and any non-default port. Origin: null and wildcards are not accepted.
Turnstile errors
- Confirm the site key belongs to the widget authorised for this hostname.
- Confirm the action matches the widget configuration.
- Reset the widget after success.
- Do not reuse a token.
Delivery expectations
Email delivery is at-least-once. A provider can accept a message and lose the response. Postvia records that as unknown and delays retry rather than aggressively duplicating.
For operator diagnostics, see the administration portal and the API error reference.