How to get AI research and outreach emails for a lead with the Coolie API

curl https://trycoolie.ai/api/v1/agents/agent-3f2a91c0/leads/actions \
  -H "Authorization: Bearer $COOLIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "research", "leads": [ { "runId": "ui-5b9e2c41", "prospectId": "p-41b7c2d9e0aa" } ] }'

{
  "queued": 1,
  "skipped": 0
}

import os
import time

import requests

API = "https://trycoolie.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['COOLIE_API_KEY']}"}
AGENT_ID = "agent-3f2a91c0"
LEAD = {"runId": "ui-5b9e2c41", "prospectId": "p-41b7c2d9e0aa"}

queued = requests.post(f"{API}/agents/{AGENT_ID}/leads/actions", headers=HEADERS,
                       json={"action": "research", "leads": [LEAD]}, timeout=60)
queued.raise_for_status()
print(queued.json())  # {'queued': 1, 'skipped': 0}

lead = None
while lead is None or lead["research"] is None or lead["sequence"] is None:
    time.sleep(30)
    page = requests.get(f"{API}/agents/{AGENT_ID}/leads", headers=HEADERS,
                        params={"limit": 100}, timeout=60).json()
    lead = next((item for item in page["leads"] if item["prospectId"] == LEAD["prospectId"]), None)

for insight in lead["research"]["insights"]:
    print(insight["id"], insight["type"], "-", insight["insight"])
for message in lead["sequence"]:
    print()
    print(f"[{message['channel']}, step {message['step']}] {message['subject'] or ''}")
    print(message["body"])

curl https://trycoolie.ai/api/v1/agents/agent-3f2a91c0/leads/insights \
  -H "Authorization: Bearer $COOLIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "runId": "ui-5b9e2c41", "prospectId": "p-41b7c2d9e0aa", "text": "Met Camille at a trade show: their two sites still plan shifts by hand." }'

curl https://trycoolie.ai/api/v1/agents/agent-3f2a91c0/leads/sequence \
  -H "Authorization: Bearer $COOLIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "runId": "ui-5b9e2c41", "prospectId": "p-41b7c2d9e0aa", "insightIds": ["c1", "s1", "w1"] }'

{
  "runId": "ui-5b9e2c41",
  "prospectId": "p-41b7c2d9e0aa",
  "agentId": "agent-3f2a91c0",
  "status": "written",
  "processedAt": "2026-10-19T09:02:13.511Z",
  "icpMatch": true,
  "aiScore": 8.4,
  "feedback": null,
  "signal": {
    "type": "hiring",
    "name": "Hiring",
    "headline": "Operations Manager",
    "detail": null,
    "url": "https://jobs.example.com/12345",
    "postedAt": "2026-10-17"
  },
  "company": {
    "name": "Northwind Health",
    "domain": "northwind.example",
    "website": "https://northwind.example",
    "linkedinUrl": "https://www.linkedin.com/company/example",
    "industry": "Hospitals and Health Care",
    "employees": 320,
    "country": "France",
    "locations": [
      "Lyon, France"
    ]
  },
  "contact": {
    "name": "Camille Martin",
    "title": "COO",
    "seniority": "c_suite",
    "linkedinUrl": "https://www.linkedin.com/in/example",
    "country": "France",
    "email": "camille.martin@northwind.example",
    "emailConfidence": 0.92,
    "phone": null
  },
  "research": {
    "companyContext": "Northwind Health runs two clinics around Lyon and is hiring an Operations Manager to run scheduling across both sites.",
    "roleTension": "As COO, Camille owns the clinics' scheduling while the team grows faster than its tools.",
    "confidence": "high",
    "insights": [
      {
        "id": "s1",
        "custom": false,
        "type": "Hiring Activity",
        "insight": "Northwind Health is hiring: Operations Manager",
        "date": "2026-10-17",
        "relevancy": "The buying signal that brought this lead in.",
        "score": null,
        "sources": [
          "https://jobs.example.com/12345"
        ],
        "hiddenProblem": null
      },
      {
        "id": "w1",
        "custom": false,
        "type": "Company News",
        "insight": "Northwind Health opened its second clinic in September.",
        "date": "2026-09-12",
        "relevancy": "A second site makes shift planning by hand harder.",
        "score": 8,
        "sources": [
          "https://news.example.com/northwind-second-clinic"
        ],
        "hiddenProblem": "Schedules kept in spreadsheets per site."
      }
    ],
    "persona": {
      "painPoint": "Planning shifts across two clinics by hand.",
      "currentSolution": "Spreadsheets per site.",
      "risks": "Gaps in cover as the team grows.",
      "differentiation": "One schedule for every site.",
      "benefits": "Hours back each week for the operations team."
    }
  },
  "sequence": [
    {
      "channel": "email",
      "step": 1,
      "subject": "Two clinics, one schedule",
      "body": "Hi Camille, congratulations on opening the second clinic. …"
    },
    {
      "channel": "linkedin",
      "step": 2,
      "subject": null,
      "body": "Hi Camille, I wrote to you about scheduling across your two sites. …"
    }
  ]
}