curl -X POST https://api.shortkit.dev/v1/surveys \
  -H "Authorization: Bearer sk_live_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Content Discovery",
    "question": "How did you discover this content?",
    "status": "draft",
    "priority": 10,
    "autoAdvanceDelay": 3.0,
    "options": [
      { "text": "Social media", "position": 0 },
      { "text": "Search", "position": 1 },
      { "text": "Friend", "position": 2 }
    ],
    "placementRules": [
      { "ruleType": "min_videos_before", "ruleValue": { "n": 3 } },
      { "ruleType": "once_per_user", "ruleValue": {} }
    ]
  }'

import requests

resp = requests.post(
    "https://api.shortkit.dev/v1/surveys",
    headers={
        "Authorization": "Bearer sk_live_your_secret_key",
        "Content-Type": "application/json",
    },
    json={
        "title": "Content Discovery",
        "question": "How did you discover this content?",
        "options": [
            {"text": "Social media", "position": 0},
            {"text": "Search", "position": 1},
            {"text": "Friend", "position": 2},
        ],
        "placementRules": [
            {"ruleType": "min_videos_before", "ruleValue": {"n": 3}},
            {"ruleType": "once_per_user", "ruleValue": {}},
        ],
    },
)
survey = resp.json()["data"]

const resp = await fetch("https://api.shortkit.dev/v1/surveys", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_live_your_secret_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title: "Content Discovery",
    question: "How did you discover this content?",
    options: [
      { text: "Social media", position: 0 },
      { text: "Search", position: 1 },
      { text: "Friend", position: 2 },
    ],
    placementRules: [
      { ruleType: "min_videos_before", ruleValue: { n: 3 } },
      { ruleType: "once_per_user", ruleValue: {} },
    ],
  }),
});
const { data: survey } = await resp.json();

{
  "data": {
    "id": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
    "title": "Content Discovery",
    "question": "How did you discover this content?",
    "status": "draft",
    "priority": 10,
    "autoAdvanceDelay": 3.0,
    "options": [
      { "id": "a1b2c3d4-...", "text": "Social media", "position": 0, "responseCount": 0, "createdAt": "2026-02-10T09:00:00Z" },
      { "id": "b2c3d4e5-...", "text": "Search", "position": 1, "responseCount": 0, "createdAt": "2026-02-10T09:00:00Z" },
      { "id": "c3d4e5f6-...", "text": "Friend", "position": 2, "responseCount": 0, "createdAt": "2026-02-10T09:00:00Z" }
    ],
    "placementRules": [
      { "id": "e5f6a7b8-...", "ruleType": "min_videos_before", "ruleValue": { "n": 3 }, "createdAt": "2026-02-10T09:00:00Z" },
      { "id": "f6a7b8c9-...", "ruleType": "once_per_user", "ruleValue": {}, "createdAt": "2026-02-10T09:00:00Z" }
    ],
    "totalResponses": 0,
    "createdAt": "2026-02-10T09:00:00Z",
    "updatedAt": "2026-02-10T09:00:00Z"
  },
  "meta": {
    "request_id": "req_srv001"
  }
}