Skip to main content
POST
/
api
/
v1
/
email-accounts
/
{email_account_id}
/
warmup
# Enable warmup with configuration
curl -X POST "https://server.smartlead.ai/api/v1/email-accounts/123/warmup?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "warmup_enabled": true,
    "total_warmup_per_day": 20,
    "daily_rampup": 5,
    "reply_rate_percentage": 30,
    "auto_adjust_warmup": true,
    "is_rampup_enabled": true
  }'

{
  "ok": true,
  "message": "Warmup settings updated successfully"
}
Email warmup helps establish sender reputation by gradually increasing daily email volume. Configure warmup to start with low volumes and progressively increase to avoid being flagged as spam.

​
Path Parameters

​
email_account_id
number
required
The email account ID to configure warmup for

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
warmup_enabled
boolean
required
Whether to enable or disable warmup for this account
​
total_warmup_per_day
number
Number of warmup emails to send per day (minimum: 1, maximum: 50)
​
daily_rampup
number
Daily increase in warmup email count (minimum: 5, maximum: 20)
​
reply_rate_percentage
number
Target reply rate percentage for warmup emails (minimum: 20, maximum: 100)
​
warmup_key_id
string
Warmup service key identifier
​
auto_adjust_warmup
boolean
Whether to automatically adjust warmup volume based on performance
​
is_rampup_enabled
boolean
Whether to enable gradual rampup of warmup volume
# Enable warmup with configuration
curl -X POST "https://server.smartlead.ai/api/v1/email-accounts/123/warmup?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "warmup_enabled": true,
    "total_warmup_per_day": 20,
    "daily_rampup": 5,
    "reply_rate_percentage": 30,
    "auto_adjust_warmup": true,
    "is_rampup_enabled": true
  }'

​
Response Codes

​
200
Success
Warmup settings updated successfully
​
401
Unauthorized
Invalid or missing API key
​
404
Not Found
Email account not found
​
422
Validation Error
Invalid parameter values (check min/max ranges)
​
500
Internal Server Error
Server error occurred
{
  "ok": true,
  "message": "Warmup settings updated successfully"
}

​
Warmup Best Practices

Recommended Settings for New Accounts:
  • Start with total_warmup_per_day: 10-15
  • Set daily_rampup: 5 to increase gradually
  • Target reply_rate_percentage: 25-30%
  • Enable auto_adjust_warmup: true for automatic optimization
Warmup Timeline:
  • Week 1: 10-15 emails/day
  • Week 2: 15-25 emails/day
  • Week 3: 25-40 emails/day
  • Week 4+: 40-50 emails/day
The daily_rampup automatically increases volume each day until reaching total_warmup_per_day.
Setting total_warmup_per_day too high for new accounts can trigger spam filters. Start conservatively and increase gradually based on warmup reputation scores.