Skip to main content

Documentation Index

Fetch the complete documentation index at: https://osforms.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

The public submission endpoint. No authentication required.

​
Endpoint

POST https://osforms.com/api/v1/f/{slug}
Accepts application/json, application/x-www-form-urlencoded, and multipart/form-data.

​
HTML form usage

<form action="https://osforms.com/api/v1/f/{slug}" method="POST">
  <input type="text" name="name" />
  <input type="email" name="email" />
  <button type="submit">Send</button>
</form>
Returns a 303 redirect to your form’s redirect URL on success.

​
API / JSON usage

curl -X POST https://osforms.com/api/v1/f/{slug} \
  -H "Content-Type: application/json" \
  -d '{"name": "Jane", "email": "jane@example.com"}'

{ "success": true, "message": "Submission received" }

​
Response codes

StatusMeaning
200Submission stored successfully (JSON clients)
303Submission stored, redirect to redirect URL (HTML forms)
403Monthly submission limit reached
422CAPTCHA verification failed
429Rate limit exceeded

​
Rate limiting

Default: 10 requests/minute per IP per form. Configurable per form in settings. When rate limited, the response includes a Retry-After header with seconds until reset.