Quickstart

Create a working endpoint in a single curl. This is the same flow the llms.txt file serves to agents.

Create an endpoint

curl -X POST https://gopigeon.dev/new -d 'recipient=you@example.com'

The response is JSON with endpoint_url, form_id, unclaimed: true, and a claim_note. Use endpoint_url directly as the action of an HTML form or the target of a fetch() call — do not rewrite the form_id.

Submit to the endpoint

curl -X POST https://gopigeon.dev/f/f_abc123def456xyz0 \
  -d 'name=Jane&email=jane@somewhere.com&message=hello'

Accepts application/x-www-form-urlencoded or application/json. Returns {"ok": true, "submission_id": "sub_..."} on success, or an HTTP 303 redirect to the form’s redirect_url if configured.