Lead Lists
Push Leads to Campaign
Push leads from a list or by IDs to a campaign
POST
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
string
required
Your SmartLead API key
Request Body
number
Target campaign ID. Either
campaignId or campaignName must be provided.string
Target campaign name. If campaign doesn’t exist, a new one is created.
string
required
Whether to
copy or move leads. Move removes them from the source.object
Lead selection criteria
number
Source list ID to push leads from
array
Specific lead IDs to push. Array of numbers, 1-10,000 items.
boolean
Set to
true to push all leads. When true, listId and leadIds should not be provided.object
Import settings for the campaign (e.g., block list handling)
object
Additional filters to apply when selecting leads
Response Codes
Success
Request successful
Bad Request
Invalid request parameters or malformed request body
Unauthorized
Invalid or missing API key
Validation Error
Request validation failed. Check parameter types and constraints.
