{"name":"Cold Leads API","version":"v1","openapi":"https://coldleads.app/api/v1/openapi.json","agent_onboarding":"No key yet? POST /api/agent/provision {owner_email, agent_id, callback_url?} → Stripe checkout_url for the human owner (Business plan) + claim_token; poll GET /api/agent/status?session_id=… with header X-Claim-Token → api_key once after payment","mcp":"https://coldleads.app/api/mcp — Model Context Protocol (Streamable HTTP, OAuth for ChatGPT or Authorization: Bearer sk_…). Includes workspace contacts, conversations, templates, campaigns, Social autoposts and social inbox, website lead capture, search and verification. Local stdio server: https://github.com/anttka4cz/mcp-server-coldleads (npx -y @coldleads/mcp-server, env COLDLEADS_API_KEY)","sdk":{"node":"https://github.com/anttka4cz/coldleads-node-sdk","install":"npm install @coldleads/sdk"},"developers":"https://coldleads.app/developers","llms":"https://coldleads.app/llms.txt","discovery":{"llms_full":"https://coldleads.app/llms-full.txt","capabilities":"https://coldleads.app/.well-known/agent-capabilities.json","agents_txt":"https://coldleads.app/.well-known/agents.txt","agents_json":"https://coldleads.app/.well-known/agents.json","mcp_server_card":"https://coldleads.app/.well-known/mcp/server-card.json"},"auth":"secret key (sk_…) in the x-api-key header or Authorization: Bearer — create it in Settings → API keys; requires the Business plan. Publishable lk_ keys only work for the website lead form.","rate_limit":"120 requests per minute per key; 5 concurrent bulk jobs per account; up to 5000 e-mails per job","credits":"1 credit per verified e-mail (cached results included) or e-mail-finder request; contact search, credits and job polling are free; monthly allowance by plan plus purchased packs","agents":"Designed to be called directly by AI agents with function calling (ChatGPT, Claude, Copilot Studio, n8n, Make): describe these endpoints as tools and pass the key in x-api-key","endpoints":{"POST /api/v1/verify":{"body":{"email":"anna@example.com","timeout_ms":"optional 1000–30000; past it the result is risky with reasons [timeout]"},"returns":"status valid|risky|invalid, score, reasons, mx, catch_all (true only when the SMTP accept-all check ran; reasons ok / smtp_unreachable tell whether the mailbox was checked)"},"POST /api/v1/verify/bulk":{"body":{"emails":["a@example.com","b@example.com"],"name":"optional"},"returns":"job id; poll GET /api/v1/verify/jobs/{id}"},"GET /api/v1/verify/jobs/{id}":{"query":{"results":"1 to include per-e-mail results"},"returns":"status, done/total, counts by bucket"},"POST /api/v1/find":{"body":{"first":"Anna","last":"Novak","domain":"example.com"},"returns":"most likely e-mail by common patterns, confidence, method verified (mailbox confirmed over SMTP) | pattern | none, catch_all, candidates"},"GET /api/v1/credits":{"returns":"plan, monthly limit, used, left"},"GET /api/v1/leads/context":{"query":{"contact_id":"or email"},"returns":"lead, contactability (do_not_contact, verification, safe_to_contact), relationship (sent/received, last reply class), next_action, last 5 messages; 0 credits"},"GET /api/v1/next-actions":{"query":{"limit":"1–100, default 25"},"returns":"lead-rescue queue (replies waiting, due follow-ups, unanswered website enquiries, leads gone quiet, leads without an owner) with kind, action, priority, reason, owner and deal value; 0 credits"},"POST /api/v1/follow-ups":{"body":{"contact_id":"or email","due_at":"ISO date-time, or in_days 0–365","note":"optional","clear":"true removes it"},"returns":"contact_id, next_action_due; never sends e-mail; 0 credits"},"GET /api/v1/activity":{"query":{"limit":"1–200, default 50"},"returns":"this workspace's API and MCP calls (operation, ok, status, error, ms), 90 days, no arguments or personal data; 0 credits"},"GET /api/v1/social":{"returns":"connected social accounts (status, last error, whether replies come into the Inbox; never logins or tokens) and plan usage; accounts are connected in the app; 0 credits"},"GET /api/v1/social/autoposts":{"query":{"autopost_id":"optional — that autopost's posts instead","limit":"1–100"},"returns":"autoposts with status, accounts, posting slots, approval, post counts and next post; 0 credits"},"POST /api/v1/social/posts":{"body":{"autopost_id":"required","text":"required","scheduled_at":"ISO date-time, or next_slot: true","variants":"optional {network: text}"},"returns":"post_id, status scheduled | pending (waits for an admin), scheduled_at, warnings; publishes nothing itself; 0 credits"},"GET /api/v1/social/messages":{"query":{"unread_only":"true for unread incoming only","limit":"1–100, default 50"},"returns":"comments, mentions and direct messages from connected social accounts and replies sent; 0 credits"},"POST /api/v1/social/messages/reply":{"body":{"message_id":"required","text":"required","confirm_send":"true — only after the user approved the exact reply"},"returns":"network, url; publishes on the social network"},"GET /api/v1/leads":{"query":{"domain":"example.com","role":"optional keyword (sales, ceo…)","limit":"1–50, default 10"},"returns":"contacts already in your Cold Leads CRM at that domain (no credits)"}},"buckets":{"valid":"domain accepts mail; mailbox confirmed over SMTP (reason ok) or not checked because no SMTP connection was possible (reason smtp_unreachable)","risky":"accept-all server, disposable domain, inconclusive SMTP answer (smtp_unknown) or time budget exceeded (timeout); role accounts stay valid with a lower score","invalid":"bad syntax, no mail server or mailbox rejected"}}