Welcome to Naturalead
Naturalead is an API platform for automated lead qualification. It replaces cold calling with LLM-driven, multi-channel conversations that qualify leads based on configurable AI agents, knowledge bases, and campaign rules.What you can do with the API
Manage Leads
Create, import, search, and sync leads from your CRM or external sources. Supports CSV import, webhook ingestion, and bulk sync.
AI Conversations
Start AI-driven conversations with leads across WhatsApp, Telegram, and Email. The AI agent qualifies leads automatically.
Run Campaigns
Launch batch outreach campaigns with rate limiting, scheduling, and lead filtering. Track performance in real time.
Configure AI Agents
Customize agent behavior with system prompts, conversation stages, guardrails, and knowledge bases for RAG.
Core concepts
| Concept | Description |
|---|---|
| Lead | A contact to be qualified. Has phone (required), email, tags, custom fields, and status. |
| Conversation | An AI-driven exchange between an agent and a lead over a messaging channel. |
| Agent Config | Defines AI behavior: system prompt, stages, guardrails, and linked knowledge bases. |
| Campaign | A batch outreach job that sends initial messages to filtered leads on a schedule. |
| Knowledge Base | Documents and web content the AI agent uses for RAG (retrieval-augmented generation). |
| Account | A tenant workspace. All data is scoped to an account. Users can belong to multiple accounts. |
Authentication
Authenticate all API requests with an API key. Pass viaX-API-Key header or Authorization: Bearer nl_*.
See Authentication for full details.
Base URL
All API requests use the following base URL:Next steps
Quickstart
Make your first API call in under 5 minutes.
API Reference
Explore every endpoint with interactive examples.