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"
}

Documentation Index

Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.