Skip to main content
POST
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

number
required
The email account ID to configure warmup for

Query Parameters

string
required
Your SmartLead API key

Request Body

boolean
required
Whether to enable or disable warmup for this account
number
Number of warmup emails to send per day (minimum: 1, maximum: 50)
number
Daily increase in warmup email count (minimum: 5, maximum: 20)
number
Target reply rate percentage for warmup emails (minimum: 20, maximum: 100)
string
Warmup service key identifier
boolean
Whether to automatically adjust warmup volume based on performance
boolean
Whether to enable gradual rampup of warmup volume

Response Codes

Success
Warmup settings updated successfully
Unauthorized
Invalid or missing API key
Not Found
Email account not found
Validation Error
Invalid parameter values (check min/max ranges)
Internal Server Error
Server error occurred

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.