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

# DeltaLead REST API: Manage Leads and Agents Programmatically

> The DeltaLead REST API lets you create and manage leads, conversations, and AI agents. All endpoints accept JSON and return JSON over HTTPS.

The DeltaLead REST API gives you programmatic access to leads, conversations, AI agents, and webhook configuration. Use it to build custom integrations, automate workflows, or sync with systems not covered by native integrations — such as a proprietary DMS, an internal data warehouse, or a bespoke CRM.

## Base URL

All API requests are made over HTTPS to the following base URL:

```text theme={null}
https://platform-api.deltalead.ai/v1
```

## Quick Example

The following request retrieves your most recent leads using `curl`. Replace `YOUR_API_KEY` with the key generated in your dashboard.

```bash theme={null}
curl https://platform-api.deltalead.ai/v1/leads \
  -H "X-API-Key: YOUR_API_KEY"
```

## Request Format

All request and response bodies use JSON. When sending data in `POST` or `PATCH` requests, include the `Content-Type: application/json` header so the API can parse the request body correctly.

```bash theme={null}
curl -X POST https://platform-api.deltalead.ai/v1/leads \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Martín Sosa", "phone": "+5491122334455"}'
```

`GET` and `DELETE` requests do not require a `Content-Type` header.

## Available Resources

<CardGroup cols={2}>
  <Card title="Leads" icon="user" href="/en/api-reference/leads/list">
    Create, retrieve, update, and delete lead records. Filter by status, channel, score, and more.
  </Card>

  <Card title="Conversations" icon="comments" href="/en/api-reference/conversations/list">
    Access the full message history for any lead across all channels — WhatsApp, email, calls, and web forms.
  </Card>

  <Card title="Agents" icon="robot" href="/en/api-reference/agents/list">
    List and configure your AI agents, including language, tone, escalation rules, and active channels.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/en/api-reference/webhooks/overview">
    Subscribe to real-time events such as new leads, status changes, and conversation milestones.
  </Card>
</CardGroup>

## Rate Limits

The API allows up to **1,000 requests per minute** per API key. If you exceed this limit, the API returns a `429 Too Many Requests` response.

Every response includes two headers to help you track your current usage:

| Header                  | Description                                                   |
| ----------------------- | ------------------------------------------------------------- |
| `X-RateLimit-Remaining` | Number of requests remaining in the current one-minute window |
| `X-RateLimit-Reset`     | Unix timestamp (UTC) at which the rate limit window resets    |

When your integration receives a `429` response, wait until `X-RateLimit-Reset` before retrying, or implement exponential backoff. See the [Errors reference](/en/api-reference/errors) for full details on `429` handling.

## Next Steps

* [Authentication](/en/api-reference/authentication) — learn how to generate and send your API key
* [Errors](/en/api-reference/errors) — understand status codes, error shapes, and retry strategies