Response Format: This endpoint returns a direct array of campaigns, not wrapped in a success object. Each campaign contains comprehensive configuration including schedule, tracking settings, AI preferences, and sending limits.
{ "message": "Invalid API Key"}
{ "error": "Resource not found"}
{ "error": "Invalid parameters provided"}
Campaign Management
Get All Campaigns
Retrieves all email campaigns for the authenticated user with comprehensive campaign data including status, schedule set
GET
/
api
/
v1
/
campaigns
/
curl -X GET "https://server.smartlead.ai/api/v1/campaigns/?api_key=YOUR_API_KEY&include_tags=true"
Response Format: This endpoint returns a direct array of campaigns, not wrapped in a success object. Each campaign contains comprehensive configuration including schedule, tracking settings, AI preferences, and sending limits.
{ "message": "Invalid API Key"}
{ "error": "Resource not found"}
{ "error": "Invalid parameters provided"}
Retrieves all email campaigns for the authenticated user with comprehensive campaign data including status, schedule settings, tracking configuration, AI matching preferences, and sending limits Essential for dashboard displays, campaign selection interfaces, and bulk operations across portfolio.
Overview
Retrieves all email campaigns for the authenticated user with comprehensive campaign data including status, schedule settings, tracking configuration, AI matching preferences, and sending limitsKey Features:
Returns campaigns ordered by ID descending (newest first)
Supports optional client_id filtering for agency/white-label accounts managing multiple clients
When include_tags=true, returns campaign tags with tag IDs, names, and colors for categorization and filtering
Returns direct array of campaign objects (not wrapped)
Query Parameters
string
required
Your SmartLead API key
number
Filter campaigns by specific client ID
boolean
default:"false"
Include campaign tags in the response
Response
boolean
Indicates if the request was successful
array
Array of campaign objects
Show Campaign Object Fields
number
Unique campaign identifier
number
ID of the user who owns this campaign
string
Campaign name set by user
string
Current campaign status: ACTIVE, PAUSED, STOPPED, ARCHIVED, DRAFTED
string
ISO 8601 timestamp when campaign was created
string
ISO 8601 timestamp of last modification
array
Tracking configuration. Array can contain:
"DONT_EMAIL_OPEN" - Disable open tracking
"DONT_LINK_CLICK" - Disable click tracking
Empty array [] - Track everything
object
Sending schedule configuration
Show Schedule Object
string
Timezone (IANA format, e.g., “America/New_York”)
array
Days of week to send (0=Sunday, 1=Monday, …, 6=Saturday)
string
Start sending time (24-hour format, e.g., “09:00”)
string
Stop sending time (24-hour format, e.g., “17:00”)
number
Minimum minutes to wait between consecutive emails. Higher values (120+) appear more natural and improve deliverability.
number
Maximum number of leads to contact per day across all email accounts
string
When to stop emailing a lead: REPLY_TO_AN_EMAIL, OPENED_EMAIL, CLICKED_LINK, or NEVER
string
Scheduled start time for campaign (ISO 8601 format), null if starting immediately
boolean
When true, SmartLead’s AI automatically matches leads with optimal email accounts based on provider and deliverability history
boolean
When true, emails are sent as plain text instead of HTML for better deliverability with technical audiences
number
Percentage of leads that receive follow-up emails (0-100)
string
Custom unsubscribe footer text
number
If this is a subsequence, references the parent campaign ID. null for main campaigns.
number
Associated client ID for agency/white-label accounts. null for direct user campaigns.
array
Campaign tags (only included if include_tags=true)
Show Tag Object
number
Tag identifier
string
Tag name
string
Tag color (hex format, e.g., “#FF5733”)
curl -X GET "https://server.smartlead.ai/api/v1/campaigns/?api_key=YOUR_API_KEY&include_tags=true"
Response Format: This endpoint returns a direct array of campaigns, not wrapped in a success object. Each campaign contains comprehensive configuration including schedule, tracking settings, AI preferences, and sending limits.
{ "message": "Invalid API Key"}
{ "error": "Resource not found"}
{ "error": "Invalid parameters provided"}
Response Codes
Success
Campaigns retrieved successfully
Unauthorized
Invalid or missing API key
Internal Server Error
Server error occurred
Filtering Campaigns
You can filter campaigns by:
Client ID: Get campaigns for a specific client
Status: Use the campaign status filter in your application logic after fetching
Tags: Include tags to filter on your end
Pagination
Currently, this endpoint returns all campaigns. For large accounts with many campaigns, consider implementing pagination on your end or contact support for enterprise pagination options.
Cache campaign lists to reduce API calls. Only fetch when you need fresh data.
Common Use Cases
Get Active Campaigns Only
Python
import requestsAPI_KEY = "YOUR_API_KEY"url = "https://server.smartlead.ai/api/v1/campaigns/"response = requests.get(url, params={"api_key": API_KEY})campaigns = response.json()active_campaigns = [ c for c in campaigns['campaigns'] if c['status'] == 'ACTIVE']print(f"Active campaigns: {len(active_campaigns)}")