Formswrite API Reference: Convert Documents to Forms and Quizzes

What Is Formswrite?

• Convert Google Docs to Google Forms — automatically generate forms from document content
• Export quizzes to LMS platforms — Moodle, Canvas, Blackboard, Brightspace, Schoology, Sakai
• Generate game-based quizzes — Kahoot, Quizizz, Blooket, Gimkit, Socrative
• Create standardized assessment files — QTI 2.1, QTI 2.2, GIFT, Aiken, Cloze, H5P
• Export to other formats — Microsoft Word, LearnDash

Base URL

Authentication

• Header: X-Access-Token: YOUR_API_TOKEN
• Query parameter: ?token=YOUR_API_TOKEN

Endpoints

POST /api/v1/convert

bashcurl -X POST https://api.formswrite.com/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "documentId": "1abc123xyz",
    "format": "google_form",
    "documentName": "Weekly Quiz"
  }'

json{
  "success": true,
  "exportId": "export-uuid",
  "downloadUrl": "https://api.formswrite.com/api/forms/exports/export-uuid",
  "fileName": "Weekly Quiz-google_form",
  "format": "google_form",
  "expiresAt": "2026-03-17T00:00:00.000Z"
}

json{
  "success": true,
  "status": "processing",
  "jobId": "12345",
  "message": "Document analysis queued. Poll for status.",
  "pollUrl": "/api/v1/convert/status/12345"
}

GET /api/v1/convert/status/:jobId

bashcurl https://api.formswrite.com/api/v1/convert/status/12345 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

json{
  "success": true,
  "jobId": "12345",
  "state": "completed",
  "progress": 100,
  "result": {
    "success": true,
    "documentName": "Weekly Quiz",
    "isQuiz": true,
    "mergedContent": {
      "title": "Weekly Quiz",
      "introduction": "Answer the following questions.",
      "questions": [
        {
          "title": "What is the capital of France?",
          "type": "MULTIPLE_CHOICE",
          "options": ["Paris", "London", "Berlin", "Madrid"],
          "required": true,
          "grading": {
            "pointValue": 1,
            "correctAnswers": ["Paris"]
          }
        }
      ]
    }
  }
}

Supported Formats

Learning Management Systems

Game-Based Platforms

Standards and Formats

Supported Question Types

Error Codes

json{
  "success": false,
  "message": "Error description"
}

Code Examples

Python

pythonimport requests

def convert(doc_id, format, name, api_token):
    response = requests.post(
        "https://api.formswrite.com/api/v1/convert",
        headers={
            "Authorization": f"Bearer {api_token}",
            "Content-Type": "application/json"
        },
        json={
            "documentId": doc_id,
            "format": format,
            "documentName": name
        }
    )
    return response.json()

# Convert to Google Form
result = convert("1abc123", "google_form", "My Quiz", "token")

# Convert to Moodle
result = convert("1abc123", "moodle", "My Quiz", "token")

# Convert to Canvas
result = convert("1abc123", "canvas", "My Quiz", "token")

Node.js

javascriptasync function convert(docId, format, name) {
  const response = await fetch('https://api.formswrite.com/api/v1/convert', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.FORMSWRITE_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      documentId: docId,
      format,
      documentName: name
    })
  });
  return response.json();
}

cURL

bashcurl -X POST https://api.formswrite.com/api/v1/convert \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"documentId":"DOC_ID","format":"moodle","documentName":"Quiz"}'

Integrations

• Zapier — Webhooks by Zapier action
• Make (Integromat) — HTTP module
• n8n — HTTP Request node
• Power Automate — HTTP action
• GitHub Actions — cURL or script step
• Custom applications — Any language with HTTP support

FAQ

What is Formswrite?

What document formats can I use as input?

How does the AI detect questions?

Is there a free tier?

How long are download URLs valid?

Can I use the API for commercial purposes?

What languages does the API support?

Is the API available globally?

Where can I get support?

Get Started