Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
leads
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/leads?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_list": [
      {
        "email": "john@company.com",
        "first_name": "John",
        "last_name": "Doe",
        "company_name": "ACME Corp",
        "custom_fields": {
          "job_title": "CEO",
          "industry": "SaaS"
        }
      },
      {
        "email": "jane@startup.io",
        "first_name": "Jane",
        "last_name": "Smith",
        "company_name": "Startup Inc"
      }
    ],
    "settings": {
      "ignore_duplicate_leads_in_other_campaign": false,
      "return_lead_ids": true
    }
  }'

{
  "success": true,
  "added_count": 2,
  "skipped_count": 0,
  "lead_ids": [789, 790],
  "message": "Leads added successfully"
}
Import leads into your campaign. Supports bulk upload (max 400 leads per request) with custom fields and duplicate/validation controls.

​
Overview

Adds leads to a campaign with comprehensive validation and duplicate handling options. Key Features:
  • Bulk import: Up to 400 leads per request
  • Custom fields support (max 200 fields)
  • Duplicate detection controls
  • Global block list checking
  • Community bounce list validation

​
Path Parameters

​
campaign_id
number
required
Campaign ID

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
lead_list
array
required
Array of lead objects (max 400 leads)
​
lead_list_ids
array
Array of lead list IDs (if importing from existing lists)
​
type
string
Import type (optional)
​
settings
object
Validation and duplicate handling settings
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/leads?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_list": [
      {
        "email": "john@company.com",
        "first_name": "John",
        "last_name": "Doe",
        "company_name": "ACME Corp",
        "custom_fields": {
          "job_title": "CEO",
          "industry": "SaaS"
        }
      },
      {
        "email": "jane@startup.io",
        "first_name": "Jane",
        "last_name": "Smith",
        "company_name": "Startup Inc"
      }
    ],
    "settings": {
      "ignore_duplicate_leads_in_other_campaign": false,
      "return_lead_ids": true
    }
  }'

​
Response Example

{
  "success": true,
  "added_count": 2,
  "skipped_count": 0,
  "lead_ids": [789, 790],
  "message": "Leads added successfully"
}