List Domain Mailboxes
curl --request GET \
--url https://api.lemlist.com/api/domains-core/mailboxes \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/domains-core/mailboxes"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/domains-core/mailboxes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/domains-core/mailboxes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/domains-core/mailboxes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"mailboxes": [
{
"_id": "dem_Rb4Nc7Fy1Hs6Jq0Wt",
"email": "john@getacme.com",
"domainId": "dom_Kd8Wq2Lr5Tx9Mz3Pv",
"status": "active",
"provider": "google",
"assignedToUserId": "usr_Ye6Ta3Uo8Ic1Mn7Bh",
"createdAt": "2026-01-15T10:31:00.000Z"
}
]
}{
"error": "Match error: Failed Match.OneOf, Match.Maybe or Match.Optional validation"
}{
"error": "Unauthorized"
}{
"error": "Internal error"
}Domains
List Domain Mailboxes
Lists the mailboxes bought on the team’s lemlist domains.
GET
/
domains-core
/
mailboxes
List Domain Mailboxes
curl --request GET \
--url https://api.lemlist.com/api/domains-core/mailboxes \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/domains-core/mailboxes"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/domains-core/mailboxes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/domains-core/mailboxes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/domains-core/mailboxes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"mailboxes": [
{
"_id": "dem_Rb4Nc7Fy1Hs6Jq0Wt",
"email": "john@getacme.com",
"domainId": "dom_Kd8Wq2Lr5Tx9Mz3Pv",
"status": "active",
"provider": "google",
"assignedToUserId": "usr_Ye6Ta3Uo8Ic1Mn7Bh",
"createdAt": "2026-01-15T10:31:00.000Z"
}
]
}{
"error": "Match error: Failed Match.OneOf, Match.Maybe or Match.Optional validation"
}{
"error": "Unauthorized"
}{
"error": "Internal error"
}
Poll this endpoint to follow mailboxes after Order Mailboxes. Canceled mailboxes are not listed.
active means the mailbox exists at the provider, not that it can send yet. SMTP mailboxes, and Google Workspace mailboxes on a domain bought or transferred through lemlist, are connected automatically. Microsoft 365 mailboxes, and Google Workspace mailboxes on a domain connected from your own registrar, must be connected by their user in the lemlist app (Settings > Sending) before campaigns can use them.Authorizations
Was this page helpful?