Skip to main content
POST
/
api
/
v1
/
email-accounts
/
{email_account_id}
curl -X POST "https://server.smartlead.ai/api/v1/email-accounts/123?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_email_per_day": 60,
    "from_name": "John Doe - Sales",
    "custom_tracking_url": "track.example.com",
    "signature": "<p>Best regards,<br>John Doe<br>Sales Manager</p>",
    "time_to_wait_in_mins": 10
  }'
{
  "ok": true,
  "message": "Email account updated successfully"
}
Updates specific email account settings without requiring re-authentication. Use this endpoint to modify daily limits, custom domains, signatures, and other non-credential settings.

Path Parameters

email_account_id
number
required
The email account ID to update

Query Parameters

api_key
string
required
Your SmartLead API key

Request Body

max_email_per_day
number
Maximum emails allowed per day (including warmup and campaign emails)
from_name
string
Display name for outgoing emails
custom_tracking_url
string
Custom domain for tracking links (e.g., “track.yourdomain.com”)
bcc
string
BCC email address for all outgoing emails
signature
string
Email signature HTML
client_id
number
Client ID to associate this email account with (for multi-tenant accounts)
time_to_wait_in_mins
number
Minimum time to wait between emails in minutes
is_suspended
boolean
Whether to suspend or unsuspend the account
curl -X POST "https://server.smartlead.ai/api/v1/email-accounts/123?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_email_per_day": 60,
    "from_name": "John Doe - Sales",
    "custom_tracking_url": "track.example.com",
    "signature": "<p>Best regards,<br>John Doe<br>Sales Manager</p>",
    "time_to_wait_in_mins": 10
  }'

Response Codes

200
Success
Email account updated successfully
401
Unauthorized
Invalid or missing API key
404
Not Found
Email account not found or you don’t have access to it
422
Validation Error
Invalid field values
500
Internal Server Error
Server error occurred
{
  "ok": true,
  "message": "Email account updated successfully"
}

Usage Notes

All fields are optional - only include the fields you want to update. Omitted fields remain unchanged.
Use this endpoint to:
  • Adjust daily sending limits as your account reputation improves
  • Add or update email signatures
  • Configure custom tracking domains
  • Change BCC settings for compliance
To update SMTP/IMAP credentials or connection settings, use the Add SMTP Email Account endpoint with the account ID included to perform an update instead.