Skip to main content
POST
/
api
/
v1
/
lead-list
curl -X POST "https://server.smartlead.ai/api/v1/lead-list/?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listName": "Q1 2025 Enterprise Prospects"}'

{
  "ok": true,
  "data": {
    "id": 500,
    "name": "Q1 2025 Enterprise Prospects",
    "created_at": "2025-12-01T10:00:00.000Z"
  }
}
Lead lists help you organize leads into logical groups before pushing them to campaigns. Create lists for different segments, sources, or campaigns.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
listName
string
required
Name for the new lead list
curl -X POST "https://server.smartlead.ai/api/v1/lead-list/?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listName": "Q1 2025 Enterprise Prospects"}'

​
Response Codes

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key
​
422
Validation Error
Request validation failed. Check parameter types and constraints.
{
  "ok": true,
  "data": {
    "id": 500,
    "name": "Q1 2025 Enterprise Prospects",
    "created_at": "2025-12-01T10:00:00.000Z"
  }
}