How do I get an API key?

Sign in, open Settings → API keys (spaceforms.io/settings/api-keys), name the key and press Create. The key starts with sf_live_ and is shown once. You can revoke it at any time.

API access is included on every account, including free. Free accounts can create unlimited forms and collect unlimited responses, and see the 10 most recent answers per form. Pro (from $14/month) shows every answer on every form.

Which question types are supported?

Short and long text, email, number, rating, multiple choice, checkboxes, dropdown, date and more — the same types as the visual builder.

Is there a rate limit?

Normal API use is not limited. AI generation inside the app is limited per user per day.

Survey API for developers and AI agents

The SpaceForms Survey API lets your code or your AI agent do everything a person can do in the app: create a survey, edit its questions, publish it, and read the answers. One REST API, one API key, and an MCP server on the same address.

Get a free API key Read the API docs

What you can do

Every action in the SpaceForms builder has an endpoint.

Create a survey with questions in one request
Update questions, title and published state
Get the public link to share
Read responses as JSON or export them as CSV
Get response counts and time of last response
Move forms to trash and restore within 30 days

Create and publish a survey in one call

The response contains the public link under url — send it to respondents straight away.

curl -X POST https://spaceforms.io/api/v1/forms \
  -H "Authorization: Bearer $SPACEFORMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Customer feedback",
    "published": true,
    "fields": [
      { "id": "q1", "type": "rating", "label": "How satisfied are you?", "required": true },
      { "id": "q2", "type": "long_text", "label": "What could we do better?" }
    ]
  }'

Built for agents, not just scripts

The same features are exposed as MCP tools, so Claude, ChatGPT developer mode and Cursor can build and run surveys for you in conversation.

Errors are short, machine-readable codes (unauthorized, not_found, questions_locked, invalid_request) so an agent can recover without guessing.

A clean base URL

All endpoints live under https://spaceforms.io/api/v1. Authenticate with Authorization: Bearer sf_live_...

Frequently asked questions

How do I get an API key?: Sign in, open Settings → API keys (spaceforms.io/settings/api-keys), name the key and press Create. The key starts with sf_live_ and is shown once. You can revoke it at any time.
What does it cost?: API access is included on every account, including free. Free accounts can create unlimited forms and collect unlimited responses, and see the 10 most recent answers per form. Pro (from $14/month) shows every answer on every form.
Which question types are supported?: Short and long text, email, number, rating, multiple choice, checkboxes, dropdown, date and more — the same types as the visual builder.
Is there a rate limit?: Normal API use is not limited. AI generation inside the app is limited per user per day.