Upload leads via CSV

Upload leads to a campaign via CSV file

Upload a CSV file containing lead data. The upload is processed asynchronously for large files, so check the progress URL for status.

CSV Requirements

• Must include an email column (required)
• Additional columns: first_name, last_name, company, custom fields
• Maximum file size: 50MB
• Maximum leads per upload: 10,000

Mapping Format

Provide a JSON mapping from CSV columns to lead fields:

{
    "email": "Email Address",
    "first_name": "First Name",
    "last_name": "Last Name",
    "company": "Company",
    "custom_industry": "Industry"
}

Example Usage

import requests

campaign_id = "550e8400-e29b-41d4-a716-446655440000"

mapping = {
    "email": "Email",
    "first_name": "First Name",
    "last_name": "Last Name",
    "company": "Company"
}

with open("leads.csv", "rb") as f:
    response = requests.post(
        f"https://api.coldsend.io/api/public/v1/campaigns/{campaign_id}/leads",
        headers={"X-API-Key": "your-api-key"},
        files={"file": f},
        data={"mapping": json.dumps(mapping)}
    )

print(response.json())