Core concepts

API reference

Every endpoint, every field, every error code.

12 min read

The FormsDock API is small. One submit endpoint, plus admin endpoints for reading submissions and managing forms.

POST /v1/submit

http

POST https://api.formdock.dev/v1/submit
Authorization: Bearer fk_live_...
Content-Type: application/json

{
  "form_id": "contact",
  "fields": { "email": "...", "message": "..." }
}

Response

json

200 OK
{
  "id": "sub_01H...",
  "queued_at": "2026-08-12T18:14:02Z",
  "spam_verdict": "allow"
}

Error codes

401 invalid_token — the bearer token is missing, malformed, or revoked.
403 form_disabled — the form is paused in the dashboard.
422 schema_violation — a required field is missing or has the wrong type.
429 rate_limited — you exceeded the per-form rate limit.