DeltaLead REST API: Manage Leads and Agents Programmatically

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:

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.

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.

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

Leads

Create, retrieve, update, and delete lead records. Filter by status, channel, score, and more.

Conversations

Access the full message history for any lead across all channels — WhatsApp, email, calls, and web forms.

Agents

List and configure your AI agents, including language, tone, escalation rules, and active channels.

Webhooks

Subscribe to real-time events such as new leads, status changes, and conversation milestones.

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 for full details on 429 handling.

Next Steps

Authentication — learn how to generate and send your API key
Errors — understand status codes, error shapes, and retry strategies

​Base URL

​Quick Example

​Request Format

​Available Resources