curl -X POST "https://api.hooked.so/v1/avatar/cm7a1v9t20003ab12cd34ef56/reaction" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "reaction": "surprise" }'

const avatarId = "cm7a1v9t20003ab12cd34ef56";
const response = await fetch(`https://api.hooked.so/v1/avatar/${avatarId}/reaction`, {
  method: "POST",
  headers: { "x-api-key": process.env.HOOKED_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ reaction: "surprise" }),
});
const { data } = await response.json();
// Poll GET /v1/avatar/{avatarId} until this reaction is COMPLETED, then use data.id as hook-demo avatarId
console.log(data.id, data.status);

import os
import requests

avatar_id = "cm7a1v9t20003ab12cd34ef56"
response = requests.post(
    f"https://api.hooked.so/v1/avatar/{avatar_id}/reaction",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
    json={"reaction": "surprise"},
)
data = response.json()["data"]
print(data["id"], data["status"])

{
  "success": true,
  "message": "Reaction generation started",
  "data": {
    "id": "cm7a2r4k80011ab12gh78ij90",
    "reaction": "surprise",
    "status": "PROCESSING",
    "videoUrl": null,
    "thumbnailUrl": null,
    "createdAt": "2026-10-05T09:20:03.000Z",
    "avatarId": "cm7a1v9t20003ab12cd34ef56",
    "usedCredits": 52
  }
}

{
  "success": false,
  "message": "customPrompt: Required for the custom reaction"
}