Lead Lists
Import Leads to List
Import leads into a specific lead list
POST
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
number
required
The ID of the lead list to import into
Query Parameters
string
required
Your SmartLead API key
Request Body
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.
string
required
A name to identify this import batch (e.g., the source CSV filename)
object
Mapping of email fields in your data
object
Custom field definitions for your lead data
object
Import settings including
ignoreGlobalBlockList (boolean) to skip blocked domain checkingResponse 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.
