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.