Sign in

v1

latestOpenAPI 3.0.02026-07-13162235.0 KB
AI Personalization

Generate an AI hook for one lead (synchronous)

Generates a single curiosity-led opener line for the lead. Billed 3 credits (3p) per fresh success; cache hits and generation failures are never charged (X-No-Charge). The lead must belong to the caller — non-owned or unknown leads return 404 (no enumeration).

post/v1/ai/hook

Request body

leadIdstring uuid required

The lead to generate for. Must belong to the caller.

localestring

Output locale (one of the 8 supported locales).

mode'native' | 'translate'

native generates directly in the target locale; translate generates in English then translates.

Response

Hook generated (or returned from cache)

successboolean

Example response

{
  "data": {
    "hook": "Curious how you weigh page-speed against the content depth your blog is clearly built around?",
    "model": "claude-haiku-4-5-20251001",
    "cost": {
      "credits": 1,
      "pence": 1
    }
  }
}