curl -X POST "https://api.hooked.so/v1/project/create/ugc-studio/product-in-hand" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Serum ad - Maria",
    "script": "I was skeptical, but after two weeks with [product]this serum[/product] my skin has never looked better.",
    "avatarId": "2",
    "productImageKey": "https://example.com/images/serum.png",
    "media": [
      "cm8w1r7d20001l708x9y8z7w6"
    ],
    "videoStyle": {
      "cameras": [
        "static-shot",
        "slow-zoom-to-the-face"
      ]
    },
    "language": "en",
    "caption": {
      "preset": "tiktok",
      "alignment": "bottom"
    },
    "webhook": "https://example.com/hooks/hooked?token=YOUR_SECRET",
    "metadata": {
      "campaign": "serum-q4"
    }
  }'

const response = await fetch("https://api.hooked.so/v1/project/create/ugc-studio/product-in-hand", {
  method: "POST",
  headers: {
    "x-api-key": "your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      script: "Okay, this blender changed my mornings. Look how fast it is.",
      avatarId: "2",
      productImageKey: "https://example.com/images/blender.png",
      webhook: "https://example.com/hooks/hooked?token=YOUR_SECRET"
    }),
});

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

import requests

response = requests.post(
    "https://api.hooked.so/v1/project/create/ugc-studio/product-in-hand",
    headers={"x-api-key": "your_api_key_here"},
    json={
        "script": "I take this bottle everywhere. It keeps water cold for a whole day.",
        "avatarId": "2",
        "productImageKey": "https://example.com/images/bottle.png",
        "webhook": "https://example.com/hooks/hooked?token=YOUR_SECRET"
    },
)
data = response.json()["data"]
print(data["projectId"], data["status"])

{
  "success": true,
  "data": {
    "projectId": "cm8x4f2qk0007l708a1b2c3d4",
    "status": "processing"
  },
  "message": "UGC ad successfully created"
}

{
  "success": false,
  "message": "productImageKey: A product photo is required for the product-in-hand format"
}

{
  "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": [["gemini"]],
  "message": "Your team uses its own provider keys (BYOK) and these are missing or invalid: Google AI (Gemini). 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 UGC ad creation. Estimated: 107, Available: 40",
  "creditsNeeded": 107,
  "creditsAvailable": 40
}

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