Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
settings
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/settings?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

{
  "success": true,
  "data": {}
}
Updates campaign configuration including: tracking settings (enable/disable opens and clicks - array format with DONT_EMAIL_OPEN/DONT_LINK_CLICK values), sending limits (max_leads_per_day, min_time_between_emails), stop conditions (when to stop emailing leads - REPLY_TO_AN_EMAIL/OPENED_EMAIL/CLIC…

​
Overview

Updates campaign configuration including: tracking settings (enable/disable opens and clicks - array format with DONT_EMAIL_OPEN/DONT_LINK_CLICK values), sending limits (max_leads_per_day, min_time_between_emails), stop conditions (when to stop emailing leads - REPLY_TO_AN_EMAIL/OPENED_EMAIL/CLICKED_LINK), AI ESP matching (intelligently pair leads with optimal email accounts), plain text mode (send_as_plain_text for better deliverability with technical audiences), follow-up percentage, and unsubscribe text Key Features:
  • Validates settings before applying

​
Path Parameters

​
campaign_id
number
required
The ID of the campaign to update

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
track_settings
object
Email tracking configuration
​
sending_limit
number
Maximum leads to contact per day
​
min_time_btwn_emails
number
Minimum minutes to wait between consecutive emails
​
stop_lead_settings
string
When to stop emailing a leadValid values:
  • REPLY_TO_AN_EMAIL - Stop on reply
  • OPENED_EMAIL - Stop after open
  • CLICKED_LINK - Stop after click
​
enable_ai_esp_matching
boolean
Use AI to match leads with best email accounts
​
send_as_plain_text
boolean
Send emails as plain text (no HTML)
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/settings?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

​
Response Codes

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key. Check your authentication.
​
404
Not Found
The requested resource (campaign, lead, email account, etc.) does not exist or you don’t have access to it
​
422
Validation Error
Request validation failed. Check parameter types, required fields, and value constraints.
​
429
Rate Limit Exceeded
Too many requests. Please slow down and retry after the rate limit resets.
​
500
Internal Server Error
Server error occurred. Please try again or contact support if the issue persists.
​
503
Service Unavailable
API is temporarily unavailable or under maintenance. Please try again later.
{
  "success": true,
  "data": {}
}

​
Settings Explained

​
Track Settings

Control what gets tracked in your emails:
  • track_open: Adds tracking pixel to detect opens
  • track_click: Wraps links to track clicks
Disable tracking for privacy-focused outreach or when targeting technical audiences who may block tracking.

​
Sending Limits

  • sending_limit: Daily cap across all email accounts
  • min_time_btwn_emails: Prevents rapid-fire sending (appears more natural)

​
Stop Lead Settings

  • REPLY_TO_AN_EMAIL: Most common - stop when they engage
  • OPENED_EMAIL: Conservative - stop after they show interest
  • CLICKED_LINK: Stop when they click a link

​
AI ESP Matching

When enabled, SmartLead’s AI:
  • Matches leads with appropriate sender accounts
  • Considers lead’s email provider
  • Optimizes for deliverability
  • Balances account usage

​
Implementation Details

Settings changes affect only future sends. In-progress leads continue with old settings. Response Format: object