Submissions

Submission shape, spam handling, and retention windows.

Submission shape

Endpoints accept application/x-www-form-urlencoded or application/json. Field names are free-form — whatever you post is what shows up in the recipient email and the dashboard.

curl -X POST https://gopigeon.dev/f/f_abc123def456xyz0 \
  -H 'Content-Type: application/json' \
  -d '{"name":"Jane","email":"jane@somewhere.com","message":"hello"}'

Honeypot: _gotcha

_gotcha is a reserved field name. Any non-empty value marks the submission as spam and drops it before it counts toward the unclaimed cap. Leave it out of real forms; include it as a hidden input for bot detection.

<!-- Honeypot: leave _gotcha empty; bots often fill every field. -->
<input type="text" name="_gotcha" style="display:none" tabindex="-1" autocomplete="off">

Redirects

If the endpoint has a configured redirect_url, successful submissions return an HTTP 303 See Other to that URL instead of the JSON response body. Useful for classic server-rendered form flows that want a confirmation page.

Retention

Submissions are retained for the owner’s plan retention window (free tier: 30 days; pro tier: 1 year). Unclaimed endpoints retain submissions until expiry or cap, whichever comes first. Spam submissions (_gotcha triggered) are dropped immediately and never stored.