For coding tools
Set up a form without touching this website — paste one prompt into your coding tool and let it do the wiring.
The prompt
Paste this into your agent (Claude Code, Kimi Code, Cursor, …):
Set up a Form2Email endpoint for this project.
1. Ask me for the destination email address and the domain my form will
live on (origin).
2. Create the endpoint:
curl -s -X POST https://form2email.terragohan.com/api/endpoints \
-H 'content-type: application/json' \
-d '{"destination_email": "<destination>", "origin": "<origin>"}'
3. The response has public_url (form target), manage_url (API), and
manage_page_url (human page). All three are secret — store them in my
project's config, never in public code.
4. Tell me to click the verification link in the destination inbox — a
human must do this; nothing works until it happens. Also tell me to
add form2email@terragohan.com as a trusted sender.
5. Once I confirm verification, wire my form to POST public_url.
Submissions are only accepted from the registered origin (exact
hostname match; register a subdomain separately if the form lives on
one).
6. Remind me: the endpoint expires 7 days after
verification. Extending is free (+7 days per call) via
POST <manage_url>/extend — the manage page has a button.
One thing no tool can do for you: clicking the verification link. The endpoint stays inert until a human does.
What the tool will do
-
Create
POST /api/endpointswith your destination address and form domain. Rate-limited to 5/hour per IP. -
You verify
A verification link lands in the destination inbox — single-use, 24 hours. Add
form2email@terragohan.comto your trusted senders so it doesn't get filtered. -
Wire the form
The tool points your form at
public_url— form-encoded or JSON, up to 64 KB. Browser posts must come from the registered origin exactly. -
Stay active
7 days per window, free extensions from the manage page. The tool can also call
POST <manage_url>/extenddirectly.
Machine-readable
Coding tools can discover the API themselves:
https://form2email.terragohan.com/api/info— the whole API as JSON: operations, fields, errors, limitshttps://form2email.terragohan.com/llms.txt— this guide as plain text, in the llms.txt conventionhttps://form2email.terragohan.com/openapi.json— the OpenAPI schema