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

# Bavlio API

> Agent-first sales outreach infrastructure. Authenticate with one API key, invoke any capability, no human-in-the-loop required.

Bavlio is a sales outreach platform built so AI agents can drive every workflow — from finding leads to personalizing emails to running multi-step campaigns — through a single REST API.

These docs are the canonical reference. Every public capability behind your `bav_live_` API key is documented here, with copy-paste examples in cURL, Python, and Node, an interactive [API reference](/api-reference/introduction), and machine-readable specs at [/openapi.json](https://api.bavlio.com/openapi.json) for tooling.

## Get going in 5 minutes

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Authenticate, make your first call, handle errors, and build a real outreach loop.
  </Card>

  <Card title="API Reference" icon="terminal" href="/api-reference/introduction">
    Every endpoint with live request examples and response schemas, generated from the OpenAPI spec.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    `bav_live_` API key format, Bearer header, key rotation, x402 wallet auth.
  </Card>

  <Card title="MCP" icon="plug" href="/integrations/mcp">
    Wire Bavlio into Claude Desktop, Cursor, and any MCP-compatible agent. Docs MCP live now; API-action MCP on the roadmap.
  </Card>
</CardGroup>

## Core capabilities

<CardGroup cols={2}>
  <Card title="Campaigns" icon="megaphone" href="/api-reference/introduction#campaigns">
    Create, launch, pause, and resume multi-step outbound campaigns. Per-campaign stats, leads, events, and AI-personalized drafts.
  </Card>

  <Card title="Email Finder & Verification" icon="envelope" href="/api-reference/introduction#email-finder--verification">
    SMTP-probe candidate emails, verify deliverability, batch-resolve full datasets.
  </Card>

  <Card title="Lead Finder" icon="user-magnifying-glass" href="/api-reference/introduction#lead-finder">
    Resolve names + companies to LinkedIn profile URLs. Batch async with status polling.
  </Card>

  <Card title="BaviMail Proxy" icon="paper-plane" href="/api-reference/introduction#bavimail-proxy">
    Send transactional email, manage sending domains and aliases, browse inbound replies.
  </Card>

  <Card title="LinkedIn (via Unipile)" icon="linkedin" href="/api-reference/introduction#connected-accounts-linkedin-via-unipile">
    Connect LinkedIn accounts, send invites and messages, sync content, manage send limits.
  </Card>

  <Card title="x402 Pay-Per-Call" icon="coins" href="https://bavlio.com/developers/x402">
    USDC-on-Base micropayments for unauthenticated agent calls. No account required.
  </Card>
</CardGroup>

## Built for agents

<AccordionGroup>
  <Accordion title="Machine-readable everything" icon="brain-circuit">
    The full API is described by an [OpenAPI 3.1 spec](https://api.bavlio.com/openapi.json) (190+ endpoints). An [`/llms.txt`](/llms.txt) index and [`/llms-full.txt`](/llms-full.txt) full-content dump are auto-generated for AI ingestion. A [docs MCP server](/integrations/mcp) is live at `bavlio.mintlify.app/mcp` for any agent that needs to query these docs as native tools (Claude Desktop, Cursor, etc.).
  </Accordion>

  <Accordion title="Honest about current state" icon="circle-info">
    These docs document what exists *today*. Where a feature is on the roadmap (`Idempotency-Key` middleware, customer-registered webhooks, restricted API keys), the page says so plainly and gives a working alternative until it ships. No aspirational claims.
  </Accordion>

  <Accordion title="No human-in-the-loop required after setup" icon="robot">
    Once you have an API key, every public capability — campaigns, leads, sender profiles, templates, sends, replies — is invocable from documentation alone. The first key still needs a dashboard login (deliberate: prevents key-from-key minting); after that, agents drive everything.
  </Accordion>
</AccordionGroup>

## Need help?

<CardGroup cols={3}>
  <Card title="Status" icon="signal" href="https://status.bavlio.com">
    API uptime, incident history, scheduled maintenance.
  </Card>

  <Card title="Support" icon="life-ring" href="https://bavlio.com/support">
    Contact the team for setup, billing, or scoping questions.
  </Card>

  <Card title="Changelog" icon="clock-rotate-left" href="https://bavlio.com/blog">
    What's new, deprecations, breaking changes.
  </Card>
</CardGroup>
