Campaign Management
Update Campaign Status
Change the status of a campaign (start, pause, stop).
POST
Change the status of a campaign (start, pause, stop) Updates campaign status to START, PAUSE, or STOP
Path Parameters
number
required
The ID of the campaign to update
Query Parameters
string
required
Your SmartLead API key
Request Body
string
required
New campaign statusValid values (from API_EMAIL_CAMPAIGN_STATUS):
START- Start or resume campaign (not “ACTIVE”)PAUSED- Temporarily pause sendingSTOPPED- Permanently stop campaign
Response Codes
Success
Request successful
Bad Request
Invalid request parameters or malformed request body
Unauthorized
Invalid or missing API key. Check your authentication.
Not Found
The requested resource (campaign, lead, email account, etc.) does not exist or you don’t have access to it
Validation Error
Request validation failed. Check parameter types, required fields, and value constraints.
Rate Limit Exceeded
Too many requests. Please slow down and retry after the rate limit resets.
Internal Server Error
Server error occurred. Please try again or contact support if the issue persists.
Service Unavailable
API is temporarily unavailable or under maintenance. Please try again later.
Status Descriptions
When to Use Each Status
ACTIVE
- Campaign is fully configured
- All sequences added
- Email accounts connected
- Leads imported
- Ready to send
PAUSED
- Need to make adjustments
- Waiting for more leads
- Testing sequences
- Temporary hold
STOPPED
- Campaign completed its goal
- Pivoting strategy
- No longer needed
- Permanently ending
ARCHIVED
- Campaign is done but keep for records
- Want to hide from active list
- May reference later
