Email Account Management
Get All Email Accounts
Retrieve all email accounts with advanced filtering and pagination options
GET
Returns email accounts with SMTP/IMAP credentials, warmup status, and campaign associations. Supports filtering by connection status, warmup state, email provider, and usage status.
Query Parameters
string
required
Your SmartLead API key
number
default:"0"
Pagination offset (minimum: 0)
number
default:"100"
Number of accounts to return per page (minimum: 1, maximum: 100)
string
Filter by usage status. Valid values:
true (used in campaigns), false (not used in campaigns)string
Filter by warmup status. Valid values:
ACTIVE, INACTIVEstring
Filter by SMTP connection status. Valid values:
true (connected), false (failed)string
Filter by warmup blocked status. Valid values:
true (blocked), false (not blocked)string
Filter by email service provider. Valid values:
GMAIL, OUTLOOK, SMTPstring
Filter by email username (partial match supported)
number
Filter by client ID (for multi-tenant accounts)
string
If
true, includes an array of campaign IDs for each email account. Returns a campaign_ids field on each account object.Response Fields
The response is an array of email account objects, each containing:Account Information
Account Information
number
Unique email account identifier
string
Display name for outgoing emails
string
Email address
string
Email account username
string
Account type:
GMAIL, OUTLOOK, or SMTPnumber | null
Associated client ID
number
Number of campaigns using this email account
timestamp
When the account was added
timestamp
When the account was last updated
SMTP Configuration
SMTP Configuration
IMAP Configuration
IMAP Configuration
Sending Configuration
Sending Configuration
Warmup Details
Warmup Details
object | null
Email warmup status and metrics
Campaign IDs (Optional)
Campaign IDs (Optional)
array
Array of campaign IDs using this email account. Only included when
fetch_campaigns=true is passed as a query parameter.Response Codes
Success
Email accounts retrieved successfully
Unauthorized
Invalid or missing API key
Validation Error
Invalid query parameters (check limit range and filter values)
Internal Server Error
Server error occurred
Usage Notes
The
tags array is always included in the response. The campaign_ids array is only included when fetch_campaigns=true is passed as a query parameter.Passwords are base64 encoded in the response for security. Decode them before use in your SMTP/IMAP clients.
