SpaceForms API

Base URL and auth

https://qmgflcglmckbadrdwter.supabase.co/functions/v1/api-v1

Authorization: Bearer sf_live_...

Create a form from one sentence (no key needed)

Authentication: optional. Send a plain-language prompt and SpaceForms writes the questions. Without a key the form is a guest form with a private, one-time claim_url (expires in 30 days) that lets the user sign up and take over the form and its answers. With a key it lands in your account. Send an idempotency_key so retries never create duplicates.

POST https://qmgflcglmckbadrdwter.supabase.co/functions/v1/api-v1/forms/from-prompt
{ "prompt": "Create a customer satisfaction survey for a SaaS company",
  "idempotency_key": "req-123" }

→ {
  "title": "SaaS Customer Satisfaction Survey",
  "status": "published",
  "form_url": "https://spaceforms.io/form/...",
  "claim_url": "https://spaceforms.io/claim/..."
}

As an MCP tool: create_form_from_prompt. Public ChatGPT endpoint with only this tool: https://qmgflcglmckbadrdwter.supabase.co/functions/v1/mcp/chatgpt.

Endpoints

GET    /forms                       list your forms
POST   /forms                       create a form
GET    /forms/{id}                  read one form incl. questions
PATCH  /forms/{id}                  update title, questions, published
DELETE /forms/{id}                  move to trash (restorable 30 days)
GET    /forms/{id}/responses        read answers
GET    /forms/{id}/responses.csv    export answers as CSV
GET    /forms/{id}/stats            counts and last response
GET    /forms/{id}/live             live results, participants, links
PATCH  /forms/{id}/live             { question_id } or { sharing_enabled }
GET    /account                     plan and limits

Create and publish a survey

curl -X POST https://qmgflcglmckbadrdwter.supabase.co/functions/v1/api-v1/forms \
  -H "Authorization: Bearer $SPACEFORMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Post-webinar feedback",
    "published": true,
    "fields": [
      { "id": "q1", "type": "radio", "label": "Was it useful?", "options": ["Yes","Somewhat","No"] },
      { "id": "q2", "type": "wordcloud", "label": "One word for today?", "maxWords": 3 },
      { "id": "q3", "type": "rating", "label": "How often do you use AI?",
        "options": ["Never","Tried once","Sometimes","Weekly","Power user"] }
    ]
  }'

The response includes the public link under url.

Reading answers

Free accounts see the first 10 answers per form; the response tells you how many are hidden via hidden_count and paywalled. Pro, lifetime and one-off form unlocks return everything.

curl https://qmgflcglmckbadrdwter.supabase.co/functions/v1/api-v1/forms/FORM_ID/responses \
  -H "Authorization: Bearer $SPACEFORMS_API_KEY"

MCP server

Point any MCP-capable assistant (Claude, ChatGPT developer mode, Cursor) at:

{
  "mcpServers": {
    "spaceforms": {
      "url": "https://qmgflcglmckbadrdwter.supabase.co/functions/v1/mcp",
      "headers": { "Authorization": "Bearer sf_live_..." }
    }
  }
}

Tools: list_forms, get_form, create_form, update_form, publish_form, delete_form, list_responses, form_stats, get_live_results, set_live_question, set_live_sharing, get_account.

Errors

{ "error": { "code": "questions_locked", "message": "..." } }

401 unauthorized     key missing, invalid or revoked
404 not_found        no such form on this account
409 questions_locked one-off unlocks allow edits for 3 days
400 invalid_request  malformed body