Skip to main content
POST
/
api
/
v1
/
leads
/
leads
/
push-between-lists
curl -X POST "https://server.smartlead.ai/api/v1/leads/leads/push-between-lists?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "move",
    "fromListId": 500,
    "toListId": 501
  }'

{
  "ok": true,
  "data": {
    "total_leads_moved": 1250
  }
}

​
Request Body

​
action
string
required
Operation type: copy or move
​
leadIds
array
Specific lead IDs to transfer. Array of numbers, 1-10,000 items. Provide either leadIds or fromListId.
​
fromListId
number
Source list ID to transfer all leads from. Provide either leadIds or fromListId.
​
toListId
number
required
Destination list ID to transfer leads to
curl -X POST "https://server.smartlead.ai/api/v1/leads/leads/push-between-lists?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "move",
    "fromListId": 500,
    "toListId": 501
  }'

​
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_moved": 1250
  }
}