Skip to main content
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 sending
  • STOPPED - Permanently stop campaign
Note: Use “START” not “ACTIVE” when activating a 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

STOPPED status is permanent and cannot be undone. Use PAUSED if you might want to resume later.

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

Implementation Details

START status triggers campaign validation and begins sending. STOP is permanent. Use PAUSE for temporary holds. Response Format: object