Getting Started

From zero to first accepted submission

This flow assumes you are creating a new form in the dashboard and testing from a browser or terminal.

1) Create a form in the dashboard

Go to /dashboard/forms/new, choose a unique slug, and create the form. The slug is your public submit address key.

2) Copy your submission endpoint

Your endpoint shape is {APP_URL}/api/s/{slug}. In development, that is usually http://localhost:3000/api/s/your-slug.

3) Send a test request

curl -X POST "http://localhost:3000/api/s/contact" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","message":"Hello DevForms"}'

4) Verify response

On success, you get 201 with accepted: true and a submission object.

5) Inspect data

Open your form dashboard and submissions table to verify accepted volume and spam rejects. You can also use Export API to download JSON/CSV.