Create API

Create and manage forms, questions, themes and uploaded images from your server.

All requests require X-EMAIL and X-API-KEY. See authentication and errors. JSON request bodies also require Content-Type: application/json. All IDs in examples are synthetic; replace them with your own values.

Build your first form

  1. Create a form and save its numeric ID.
  2. Create questions using that ID as a string in surveyId. A welcome question is created automatically at order 0.
  3. Optionally create a theme and assign its ID through Update a form.
  4. Review your form, then set its status to Collecting when it is ready for respondents.

Owner and Admin accounts can write unless marked read-only. Members can read. Account expiry, plan limits and individual endpoint checks can also reject requests. These APIs do not replace every builder feature; use the builder for complex question and logic configuration.

Endpoints

Download the Postman collection. Set the baseUrl, email and apiKey environment variables before sending a request. Keep credentials private and use disposable forms when testing updates or deletes.