Skip to main content
POST
/
api
/
v1
/
leads
/
push-to-campaign
curl -X POST "https://server.smartlead.ai/api/v1/leads/push-to-campaign?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": 12345,
    "action": "copy",
    "leadList": {
      "listId": 500
    }
  }'

{
  "ok": true,
  "data": {
    "total_leads": 1250,
    "pushed": 1200,
    "duplicates": 50
  }
}
Move or copy leads into a campaign for outreach. You can push specific leads by ID, all leads from a list, or all leads in your account.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
campaignId
number
Target campaign ID. Either campaignId or campaignName must be provided.
​
campaignName
string
Target campaign name. If campaign doesn’t exist, a new one is created.
​
action
string
required
Whether to copy or move leads. Move removes them from the source.
​
leadList
object
Lead selection criteria
​
leadList.listId
number
Source list ID to push leads from
​
leadList.leadIds
array
Specific lead IDs to push. Array of numbers, 1-10,000 items.
​
leadList.allLeads
boolean
Set to true to push all leads. When true, listId and leadIds should not be provided.
​
csvSettings
object
Import settings for the campaign (e.g., block list handling)
​
filters
object
Additional filters to apply when selecting leads
curl -X POST "https://server.smartlead.ai/api/v1/leads/push-to-campaign?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": 12345,
    "action": "copy",
    "leadList": {
      "listId": 500
    }
  }'

​
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": 1250,
    "pushed": 1200,
    "duplicates": 50
  }
}