v1

latestOpenAPI 3.0.02026-07-13162235.0 KB
AI Personalization

Generate an AI subject line for one lead (synchronous)

Identical contract to POST /v1/ai/hook but produces a subject line. Billed 3 credits (3p) per fresh success; cache hits and failures are never charged.

post/v1/ai/subject

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

Subject generated (or returned from cache)

successboolean

Example response

{
  "data": {
    "subject": "The page-speed gap behind your blog's reach",
    "cost": {
      "credits": 1,
      "pence": 1
    }
  }
}