curl -X POST "https://api.hooked.so/v1/avatar/create/from-photo" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Maya", "imageUrl": "https://cdn.example.com/team/maya.jpg", "gender": "Female" }'

const response = await fetch("https://api.hooked.so/v1/avatar/create/from-photo", {
  method: "POST",
  headers: { "x-api-key": process.env.HOOKED_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Maya", imageUrl: "https://cdn.example.com/team/maya.jpg", gender: "Female" }),
});
const { data } = await response.json();
console.log(data.id, data.status); // use data.id as avatarId

import os
import requests

response = requests.post(
    "https://api.hooked.so/v1/avatar/create/from-photo",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
    json={"name": "Maya", "imageUrl": "https://cdn.example.com/team/maya.jpg", "gender": "Female"},
)
data = response.json()["data"]
print(data["id"], data["status"])

{
  "success": true,
  "message": "Avatar created",
  "data": {
    "id": "cm7a1v9t20003ab12cd34ef56",
    "name": "Maya",
    "type": "Realistic",
    "gender": "Female",
    "age": "Young Adult",
    "image": "https://cdn.hooked.so/team/public/image/cm7a1v9t2/maya.png?X-Amz-Signature=...",
    "status": "COMPLETED",
    "situation": ["Kitchen"],
    "emotions": ["Happy"],
    "skinTone": "medium",
    "isCustom": true,
    "source": "custom",
    "createdAt": "2026-10-05T09:12:44.000Z",
    "usedCredits": 200
  }
}

{
  "success": false,
  "message": "imageUrl: Must be a JPEG, PNG or WEBP image"
}