Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
email-accounts
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/email-accounts?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email_account_ids": [456, 457, 458]}'

{
  "ok": true
}
Associates one or more email accounts with a campaign for automatic sender rotation SmartLead distributes emails across added accounts to maximize deliverability, avoid ESP limits, and build sender reputation

​
Overview

Associates one or more email accounts with a campaign for automatic sender rotation Key Features:
  • Validates account ownership and connection status before adding
Accounts must be successfully connected (is_smtp_success=true, is_imap_success=true) and not suspended

​
Path Parameters

​
campaign_id
number
required
The campaign ID

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
email_account_ids
array
required
Array of email account IDs to add to the campaignExample: [456, 457, 458]
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/email-accounts?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email_account_ids": [456, 457, 458]}'

​
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.
{
  "ok": true
}

​
Best Practices

Use Multiple Accounts: Add 5-10 email accounts for better deliverability and higher sending volume
Ensure Warmup: Only add accounts that are warmed up (reputation >80%)
Check Limits: Make sure accounts have sufficient daily sending capacity

​
Account Rotation

SmartLead automatically rotates between added accounts to:
  • Distribute sending load
  • Improve deliverability
  • Build sender reputation
  • Maximize daily volume

​
Implementation Details

Accounts are immediately available for rotation. Ensure accounts are warmed up before adding to campaigns. Response Format: object