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

StatusCheck
403 origin_not_allowedThe request origin must exactly match an allowed website origin. Server clients must send Origin.
403 verification_failedTurnstile token missing, expired, reused, wrong hostname/action, or honeypot filled.
404 form_unavailableThe form, website or customer is disabled, or the public ID is wrong.
409 idempotency_conflictThe same key was used with a different payload. Use a new key for changed content.
413 payload_too_largeThe body exceeds 64 KiB.
415 unsupported_media_typeFiles, nested objects or an unsupported content type were sent.
422 validation_failedA configured required field is missing or a field is not allowed.
429 rate_limitedWait for Retry-After.
503 temporarily_unavailableThe form is not ready, Redis is unavailable, or Turnstile verification is down.

The request was accepted but no email arrived

  1. Open the submission in the Postvia inbox.
  2. Check the delivery timeline and status.
  3. Review the safe error category on the delivery.
  4. Confirm the queue worker and scheduler are running.
  5. Resend manually if the delivery is permanently failed or exhausted.
  6. 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.