# 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
}'
import requests
API_KEY = "YOUR_API_KEY"
account_id = 123
# Enable warmup
payload = {
"warmup_enabled": True,
"total_warmup_per_day": 20,
"daily_rampup": 5,
"reply_rate_percentage": 30,
"auto_adjust_warmup": True,
"is_rampup_enabled": True
}
response = requests.post(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup",
params={"api_key": API_KEY},
json=payload
)
result = response.json()
if result.get('ok'):
print(f"Warmup configured: {payload['total_warmup_per_day']} emails/day")
# Disable warmup
disable_payload = {"warmup_enabled": False}
response = requests.post(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup",
params={"api_key": API_KEY},
json=disable_payload
)
const API_KEY = 'YOUR_API_KEY';
const accountId = 123;
// Enable warmup
const payload = {
warmup_enabled: true,
total_warmup_per_day: 20,
daily_rampup: 5,
reply_rate_percentage: 30,
auto_adjust_warmup: true,
is_rampup_enabled: true
};
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/${accountId}/warmup?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
}
);
const result = await response.json();
if (result.ok) {
console.log(`Warmup configured: ${payload.total_warmup_per_day} emails/day`);
}
{
"ok": true,
"message": "Warmup settings updated successfully"
}
{
"message": "Invalid API Key"
}
{
"error": "total_warmup_per_day must be less than or equal to 50"
}
Email Account Management
Update Warmup Settings
Configure email warmup parameters to gradually build sender reputation
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
}'
import requests
API_KEY = "YOUR_API_KEY"
account_id = 123
# Enable warmup
payload = {
"warmup_enabled": True,
"total_warmup_per_day": 20,
"daily_rampup": 5,
"reply_rate_percentage": 30,
"auto_adjust_warmup": True,
"is_rampup_enabled": True
}
response = requests.post(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup",
params={"api_key": API_KEY},
json=payload
)
result = response.json()
if result.get('ok'):
print(f"Warmup configured: {payload['total_warmup_per_day']} emails/day")
# Disable warmup
disable_payload = {"warmup_enabled": False}
response = requests.post(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup",
params={"api_key": API_KEY},
json=disable_payload
)
const API_KEY = 'YOUR_API_KEY';
const accountId = 123;
// Enable warmup
const payload = {
warmup_enabled: true,
total_warmup_per_day: 20,
daily_rampup: 5,
reply_rate_percentage: 30,
auto_adjust_warmup: true,
is_rampup_enabled: true
};
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/${accountId}/warmup?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
}
);
const result = await response.json();
if (result.ok) {
console.log(`Warmup configured: ${payload.total_warmup_per_day} emails/day`);
}
{
"ok": true,
"message": "Warmup settings updated successfully"
}
{
"message": "Invalid API Key"
}
{
"error": "total_warmup_per_day must be less than or equal to 50"
}
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
# 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
}'
import requests
API_KEY = "YOUR_API_KEY"
account_id = 123
# Enable warmup
payload = {
"warmup_enabled": True,
"total_warmup_per_day": 20,
"daily_rampup": 5,
"reply_rate_percentage": 30,
"auto_adjust_warmup": True,
"is_rampup_enabled": True
}
response = requests.post(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup",
params={"api_key": API_KEY},
json=payload
)
result = response.json()
if result.get('ok'):
print(f"Warmup configured: {payload['total_warmup_per_day']} emails/day")
# Disable warmup
disable_payload = {"warmup_enabled": False}
response = requests.post(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup",
params={"api_key": API_KEY},
json=disable_payload
)
const API_KEY = 'YOUR_API_KEY';
const accountId = 123;
// Enable warmup
const payload = {
warmup_enabled: true,
total_warmup_per_day: 20,
daily_rampup: 5,
reply_rate_percentage: 30,
auto_adjust_warmup: true,
is_rampup_enabled: true
};
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/${accountId}/warmup?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
}
);
const result = await response.json();
if (result.ok) {
console.log(`Warmup configured: ${payload.total_warmup_per_day} emails/day`);
}
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
{
"ok": true,
"message": "Warmup settings updated successfully"
}
{
"message": "Invalid API Key"
}
{
"error": "total_warmup_per_day must be less than or equal to 50"
}
Warmup Best Practices
Recommended Settings for New Accounts:
- Start with
total_warmup_per_day: 10-15 - Set
daily_rampup: 5to increase gradually - Target
reply_rate_percentage: 25-30% - Enable
auto_adjust_warmup: truefor 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
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.