public

POST /v1/public/site-forms/submit

Send a static site's form to a mailbox on that site's own domain.

All public endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

Authentication

This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X POST https://api.zinndigital.com/v1/public/site-forms/submit \
  -H "Content-Type: application/json" \
  -d '{ "_to": <string>, "_email": <string> }'

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

Anonymous — the house form backend for a STATIC site we host (docs/1185). A plain HTML <form method="post"> on the site posts here; the engine e-mails the answers to <_to>@<the site's domain> with the visitor as Reply-To, sends the visitor a short confirmation, and stores nothing. ⛔ The site is the one serving the request's Origin (else Referer) host, and the recipient must be an ACTIVE, receiving mailbox on that site's own domain in the SAME org — never any other address. A Cloudflare Turnstile token (cf-turnstile-response) is verified against the site's OWN widget; no widget, no form. A filled honeypot (_website) is accepted silently and sends nothing. Charged against a fail-closed per-IP and global budget before the body is parsed. A browser form gets a 303 back to the same site: _next?sent=1 on success, _back?sent=0&reason=<code> on refusal. A caller sending Accept: application/json gets JSON and a status code instead. Every body field not starting with _ is a question and its answer, mailed in the order sent.

Parameters

NameTypeRequiredWhat it is
Origin (header)stringNoSet by the browser; names the site. Referer is the fallback.

Request body

NameTypeRequiredWhat it is
_tostringYesLocal part of the site's mailbox, e.g. coach.
_emailstringYesThe visitor's address — the Reply-To.
_namestringNo—
_formstringNoShown in the e-mail subject.
_nextstringNoSame-site path after success.
_backstringNoSame-site path after a refusal.
_localestringNoLanguage of the two e-mails.
_websitestringNoHoneypot — leave empty.
cf-turnstile-responsestringNo—

Response

NameTypeRequiredWhat it is
statusstring<sent, refused>Yes—
reasonstring<origin, recipient, invalid, email, not_enabled, verification, rate, unavailable>No—

Errors this endpoint can return

400 · 403 · 429 · 503