API Overview#

The formdata.dev API has two surfaces:

Base URL#

Or, if you created a subdomain during account setup:

Authentication#

All admin endpoints (except account creation) require a tenant key passed in the x-tenant-key header:

curl https://api.formdata.dev/v1/admin/forms \
  -H "x-tenant-key: sk_live_abc123..."

The ingestion endpoint requires no authentication — the public key in the URL path identifies the form.

Response Format#

Every response returns JSON with an ok boolean:

Success:

{
  "ok": true,
  ...
}

Error:

{
  "ok": false,
  "error": "Human-readable message"
}

Validation errors return a Zod flatten() structure:

{
  "ok": false,
  "error": {
    "formErrors": [],
    "fieldErrors": {
      "slug": ["String must contain at least 2 character(s)"]
    }
  }
}

Status Codes#

Endpoint Reference#

Ingestion#

Admin — Accounts#

Admin — Forms#

Admin — Destinations#

Admin — Keys#