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
number
Minimum warmup emails per day (integer, minimum: 1, maximum: 50). Cannot exceed the resolved warmup_max_count. When omitted, it is set to warmup_max_count - 5 (or warmup_max_count if that is 5 or less). Applied only when warmup_enabled is true.
number
Maximum warmup emails per day (integer, minimum: 1, maximum: 50). Cannot exceed the daily warmup cap set by total_warmup_per_day. When omitted, it is set to that cap. Applied only when warmup_enabled is true.
boolean
Send warmup emails only on weekdays. When omitted, the account’s current value is kept. Applied only when warmup_enabled is true.
boolean
Warm up the account’s custom domain tracking link. When omitted, the account’s current value is kept. Applied only when warmup_enabled is true.

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.