Individual Lookup

Generate one personalized snippet from a single prompt. Synchronous, returns the text directly.

POST /personalize_with_ai

Costs 0.5 credits — the same rate a row of List Lookup costs. Returns the generated text directly in the response, no list and no polling.

Pass a complete, self-contained prompt describing the personalization you want. The response contains the generated text in ai_generated_text.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
prompt	string	The prompt describing the personalization to generate.

Response

Field	Type	Description
ai_generated_text	string	The copy the model wrote. null when nothing came back.

This is the same name as the list column the List Lookup route writes to, so the same field works on both routes.

The record is under data. See Response Format for the fields every endpoint returns.

Example

Input

{
  "api_key": "your_api_key",
  "prompt": "Write a one-sentence cold email icebreaker for Sam Altman, CEO of OpenAI."
}

Output

{
  "status": "success",
  "data": {
    "ai_generated_text": "Sam, as someone building the future of AI, I thought you'd appreciate a quick note from one curious mind to another."
  },
  "credits_used": 0.5,
  "credits_remaining": 4822.5,
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "prompt: Field required"
  },
  "success": false
}

To personalize every contact in a list in one call instead, use List Lookup.