Skip to main content
POST
/
api
/
v1
/
lead-list
/
{id}
/
import
curl -X POST "https://server.smartlead.ai/api/v1/lead-list/500/import?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leadList": [
      {"email": "john@company.com", "first_name": "John", "last_name": "Doe", "company": "ACME Corp"},
      {"email": "jane@startup.io", "first_name": "Jane", "last_name": "Smith", "company": "Startup Inc"}
    ],
    "fileName": "enterprise-prospects-jan2025.csv",
    "csvSettings": {
      "ignoreGlobalBlockList": false
    }
  }'

{
  "ok": true,
  "data": {
    "total_leads": 2,
    "imported": 2,
    "duplicates": 0,
    "blocked": 0
  }
}
Bulk import leads into a list. Each lead object should contain at least an email field. Custom fields and CSV settings can be configured.

​
Path Parameters

​
id
number
required
The ID of the lead list to import into

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
leadList
array
required
Array of lead objects to import. Each lead should contain at minimum an email field, plus any additional fields like first_name, last_name, company, etc.
​
fileName
string
required
A name to identify this import batch (e.g., the source CSV filename)
​
emailFieldsAdded
object
Mapping of email fields in your data
​
customFields
object
Custom field definitions for your lead data
​
csvSettings
object
Import settings including ignoreGlobalBlockList (boolean) to skip blocked domain checking
curl -X POST "https://server.smartlead.ai/api/v1/lead-list/500/import?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leadList": [
      {"email": "john@company.com", "first_name": "John", "last_name": "Doe", "company": "ACME Corp"},
      {"email": "jane@startup.io", "first_name": "Jane", "last_name": "Smith", "company": "Startup Inc"}
    ],
    "fileName": "enterprise-prospects-jan2025.csv",
    "csvSettings": {
      "ignoreGlobalBlockList": false
    }
  }'

​
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": {
    "total_leads": 2,
    "imported": 2,
    "duplicates": 0,
    "blocked": 0
  }
}