> ## Documentation Index
> Fetch the complete documentation index at: https://docs.naturalead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Naturalead API — automate lead qualification with AI-driven conversations

# 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

<CardGroup cols={2}>
  <Card title="Manage Leads" icon="users">
    Create, import, search, and sync leads from your CRM or external sources. Supports CSV import, webhook ingestion, and bulk sync.
  </Card>

  <Card title="AI Conversations" icon="messages">
    Start AI-driven conversations with leads across WhatsApp, Telegram, and Email. The AI agent qualifies leads automatically.
  </Card>

  <Card title="Run Campaigns" icon="rocket">
    Launch batch outreach campaigns with rate limiting, scheduling, and lead filtering. Track performance in real time.
  </Card>

  <Card title="Configure AI Agents" icon="robot">
    Customize agent behavior with system prompts, conversation stages, guardrails, and knowledge bases for RAG.
  </Card>
</CardGroup>

## 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 via `X-API-Key` header or `Authorization: Bearer nl_*`.

See [Authentication](/authentication) for full details.

## Base URL

All API requests use the following base URL:

```
https://api.naturalead.ai/api
```

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Make your first API call in under 5 minutes.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore every endpoint with interactive examples.
  </Card>
</CardGroup>
