Skip to main content
GET
Returns the same payload as Get Email Account by ID. Use this when you know the address but not the account ID, so you don’t have to page through Get All Email Accounts to find it.

Query Parameters

string
required
Your SmartLead API key
string
required
The email address to look up, matched against the account’s from_email. Case-insensitive for addresses stored in lowercase; otherwise pass the address exactly as it appears in from_email.
boolean
default:"false"
If true, includes array of campaign IDs using this email account
boolean
default:"false"
If true, includes the tags assigned to this email account

Response Fields

Identical to Get Email Account by ID, including warmup_details and the optional campaign_ids and tags arrays.

Response Codes

Success
Email account retrieved successfully
Bad Request
email is missing or not a valid email address
Unauthorized
Invalid or missing API key
Not Found
No email account with that address exists on your account
Internal Server Error
Server error occurred

Usage Notes

This endpoint returns decoded passwords in plain text. Use HTTPS and secure storage when handling this sensitive data.
A 404 is the cheapest way to check whether an address is already connected, so you can use this endpoint to test for existence before calling Add SMTP Account.