public
POST /v1/public/site-forms/submit
Send a static site's form to a mailbox on that site's own domain.
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
| Name | Type | Required | What it is |
|---|---|---|---|
Origin (header) | string | No | Set by the browser; names the site. Referer is the fallback. |
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
_to | string | Yes | Local part of the site's mailbox, e.g. coach. |
_email | string | Yes | The visitor's address — the Reply-To. |
_name | string | No | — |
_form | string | No | Shown in the e-mail subject. |
_next | string | No | Same-site path after success. |
_back | string | No | Same-site path after a refusal. |
_locale | string | No | Language of the two e-mails. |
_website | string | No | Honeypot — leave empty. |
cf-turnstile-response | string | No | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
status | string<sent, refused> | Yes | — |
reason | string<origin, recipient, invalid, email, not_enabled, verification, rate, unavailable> | No | — |
Errors this endpoint can return
400 · 403 · 429 · 503