Skip to main content
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, INACTIVE
string
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, SMTP
string
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:
number
Unique email account identifier
string
Display name for outgoing emails
string
Email address
string
Email account username
string
Account type: GMAIL, OUTLOOK, or SMTP
number | 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
string
SMTP server hostname
number
SMTP server port
string
SMTP port type (SSL/TLS/STARTTLS)
boolean
Whether SMTP connection is successful
string | null
SMTP connection error message if failed
string
IMAP server hostname
number
IMAP server port
string
IMAP port type (SSL/TLS)
string
IMAP username
boolean
Whether IMAP uses different credentials than SMTP
boolean
Whether IMAP connection is successful
string | null
IMAP connection error message if failed
number
Maximum messages allowed per day
number
Messages sent today
string | null
Email signature HTML
string | null
Custom domain for tracking links
string | null
BCC email address for all outgoing emails
string | null
Custom reply-to email address
number
Minimum time to wait between emails (in minutes)
object | null
Email warmup status and metrics
array
Tags assigned to this email account. Always included in the response.
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.
Use filters to find specific accounts:
  • Filter by isSmtpSuccess=false to find accounts with connection issues
  • Filter by isInUse=false to find unused accounts
  • Filter by emailWarmupStatus=ACTIVE to find accounts currently warming up