Menu

Plain HTML

A working HTML form that posts to gopigeon. Zero JavaScript, zero dependencies — the simplest possible integration.

One-liner

<!-- Create the endpoint once (agent-time, not request-time):
     curl -X POST https://gopigeon.dev/new -d 'recipient=you@example.com'
     → returns { "endpoint_url": "https://gopigeon.dev/f/f_abc123def456xyz0", ... } -->
<form action="https://gopigeon.dev/f/f_abc123def456xyz0" method="POST">
  <input type="text" name="name" placeholder="Name" required>
  <input type="email" name="email" placeholder="Email" required>
  <textarea name="message" placeholder="Message" required></textarea>
  <!-- Honeypot: DO NOT include a field named _gotcha in real forms -->
  <button type="submit">Send</button>
</form>

How it works

Point the action of a native <form> at your endpoint URL and pick method="POST". The browser form-encodes every named input and sends it as application/x-www-form-urlencoded. gopigeon accepts it, relays to the destination(s), and returns a JSON body or a 303 redirect depending on whether a redirect_url is configured.

Create the endpoint once (agent-time, not request-time) via the curl shown in the comment block above. That curl response is where the endpoint_url you paste into action comes from — do not try to synthesize or rewrite the form ID.

The email you passed as recipient above gets a one-click claim link on the first real submission — that is how you become the authenticated owner.

Not what you're looking for? See the full surface at /llms.txt.