curl -X POST "https://api.hooked.so/v1/project/create/quiz-video" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Geography quiz",
    "voiceId": "1004",
    "questions": [
      { "question": "What is the capital of Australia?", "options": ["Sydney", "Canberra", "Melbourne"], "correctIndex": 1 },
      { "question": "Which river is the longest?", "options": ["Amazon", "Nile", "Yangtze", "Mississippi"], "correctIndex": 1 }
    ],
    "answerSeconds": 4,
    "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET"
  }'

const response = await fetch("https://api.hooked.so/v1/project/create/quiz-video", {
  method: "POST",
  headers: {
    "x-api-key": "your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title: "Geography quiz",
    voiceId: "1004",
    questions: [
      { question: "What is the capital of Australia?", options: ["Sydney", "Canberra", "Melbourne"], correctIndex: 1 },
      {
        question: "Which river is the longest?",
        options: ["Amazon", "Nile", "Yangtze", "Mississippi"],
        correctIndex: 1,
      },
    ],
    answerSeconds: 4,
    webhook: "https://example.com/hooked/webhook?token=YOUR_SECRET",
  }),
});

const { data } = await response.json();
console.log(data.projectId);

import requests

response = requests.post(
    "https://api.hooked.so/v1/project/create/quiz-video",
    headers={"x-api-key": "your_api_key_here"},
    json={
        "title": "Geography quiz",
        "voiceId": "1004",
        "questions": [
            {"question": "What is the capital of Australia?", "options": ["Sydney", "Canberra", "Melbourne"], "correctIndex": 1},
            {
                "question": "Which river is the longest?",
                "options": ["Amazon", "Nile", "Yangtze", "Mississippi"],
                "correctIndex": 1,
            },
        ],
        "answerSeconds": 4,
        "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET",
    },
)

print(response.json()["data"]["projectId"])

{
  "success": true,
  "data": {
    "projectId": "cm4x9k2p10001ab12cd34ef56",
    "status": "processing"
  },
  "message": "Quiz Video successfully created"
}

{
  "success": false,
  "message": "questions.1.correctIndex: correctIndex 3 is out of range for 3 options"
}

{
  "code": "not_authenticated",
  "message": "Not authenticated",
  "errorCode": "NOT_AUTHENTICATED",
  "details": { "x-api-key": "Header not provided or API Key invalid" }
}

{
  "success": false,
  "code": "missing_credentials",
  "errorCode": "MISSING_CREDENTIALS",
  "missingProviders": ["openrouter", "elevenlabs"],
  "message": "Your team uses its own provider keys (BYOK) and these are missing or invalid: OpenRouter, ElevenLabs. Add them in Settings → AI keys."
}

{
  "success": false,
  "code": "subscription_required",
  "errorCode": "SUBSCRIPTION_REQUIRED",
  "message": "Your team generates with Hooked's keys, which are paid by your plan. Subscribe to keep generating."
}

{
  "success": false,
  "errorCode": "INSUFFICIENT_CREDITS",
  "message": "Not enough credits for Quiz Video. Needed: 40, Available: 12",
  "creditsNeeded": 40,
  "creditsAvailable": 12
}

{
  "code": "entitlement_required",
  "error": "entitlement_required",
  "message": "This endpoint requires the \"app\" product.",
  "product": "app"
}