Core Resources
Leads
Create, manage, and track leads through the sales pipeline. Leads support custom fields, scoring, assignment, duplicate detection, and full lifecycle management.
Lead lifecycle
Status transitions, scoring, and qualification
Assignment
Assign to users or teams with routing rules
Custom fields
Key-value pairs and lead types
Create Lead
Creates a new lead record. Duplicate detection runs asynchronously after creation.
Body Parameters
| Parameter | Type | Description |
|---|---|---|
emailreq | string | Contact email address |
firstNamereq | string | First name of the lead |
lastNamereq | string | Last name of the lead |
phone | string | Phone number with country code |
source | stringwebreferralapiimportmanual | Lead source identifier |
status | stringnewcontactedqualifiedunqualified | Initial status |
score | number | Initial lead score (0-100) |
customFields | object | Key-value pairs for custom field values |
Request
HTTP
http
POST https://api.leadron.io/v1/leads
X-API-Key: ldr_live_sk_a1b2c3d4e5f6g7h8i9j0
Content-Type: application/jsonBody
json
1
2
3
4
5
6
7
8
9
{
"email": "jane.doe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"source": "web",
"customFields": {
"company": "Acme Inc"
}
}Response201Created
201 Response
json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"success": true,
"status": 201,
"message": "Resource created successfully",
"data": {
"id": "6789abcdef012345",
"tenantId": "acme-corp",
"email": "jane.doe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"status": "new",
"score": 0,
"createdAt": "2026-02-08T14:30:00.000Z"
},
"meta": {
"timestamp": "2026-02-08T14:30:00.000Z",
"version": "v1"
}
}