Skip to main content
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 checking

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.