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

# Direct REST API

> Trigger conversations and ingest messages programmatically using our REST endpoints.

The Leadblanc API lets you embed conversation capabilities into custom mobile apps, voice frontends, internal CRMs, and backend workflow automations.

## Authentication

All API requests require a Bearer token passed in the `Authorization` HTTP header.

Generate your API keys in the dashboard under **Settings > API Keys** (available on Pro and Enterprise tiers).

```http theme={null}
Authorization: Bearer lb_live_xxxxxxxxxxxxxxxxxxxxxxxx
```

***

## Base URL

```bash theme={null}
https://api.leadblanc.com/v1
```

***

## Send Message Request

```bash theme={null}
curl -X POST "https://api.leadblanc.com/v1/chat" \
  -H "Authorization: Bearer lb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "conv_98231",
    "customer": {
      "name": "Alex Mercer",
      "email": "alex@example.com"
    },
    "message": "Can you check if order #4091 has shipped?"
  }'
```

### Response

```json theme={null}
{
  "status": "success",
  "data": {
    "message_id": "msg_01J8F2",
    "reply": "Order #4091 shipped yesterday via DHL Express! Your tracking number is DHL-99218204.",
    "agent_name": "Leadblanc Assistant",
    "created_at": "2026-11-14T07:49:00Z"
  }
}
```

> [!TIP]
>
> For detailed parameter definitions and error status codes, check the full [API Reference](https://docs.leadblanc.com/api-reference/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.