smartlead-api

Send a POST request to /campaigns/{id}/leads with your API key as a query parameter and a body containing a lead_list array. Each lead can include email, first_name, last_name, company_name, and custom_fields, batched up to 100 leads per request.

Use the seq_variants array inside each sequence object when posting to /campaigns/{id}/sequences. Each variant needs a variant_label, subject, and email_body. Do not include a distribution field because Smartlead splits traffic evenly automatically.

All requests authenticate with an api_key query parameter, for example ?api_key={SMARTLEAD_API_KEY}. For sub-clients, pass the main key plus a client_id parameter, or use the client's own API key directly for custom key clients.

The standard plan allows 2,000 requests per minute and higher plans allow 3,000 per minute. Retry on 429 and 5xx responses with exponential backoff, and use a concurrency limiter like p-limit with 8-15 concurrent requests for bulk operations.

Call GET /campaigns/{id}/analytics-by-date with start_date and end_date in YYYY-MM-DD format to get metrics like sent_count and reply_count. For account-wide data, use /analytics/day-wise-overall-stats or /analytics/overall-stats-v2.