Add multiple SMTP email accounts
curl --request POST \
--url https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"inboxes": [
{
"email_address": "<string>",
"display_name": "<string>",
"inbox_type": "<string>",
"smtp_host": "<string>",
"smtp_port": 32768,
"smtp_username": "<string>",
"smtp_password": "<string>",
"imap_host": "<string>",
"imap_port": 32768,
"imap_username": "<string>",
"imap_password": "<string>",
"daily_limit": 100,
"smtp_use_tls": true,
"imap_use_ssl": true
}
]
}
'import requests
url = "https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk"
payload = { "inboxes": [
{
"email_address": "<string>",
"display_name": "<string>",
"inbox_type": "<string>",
"smtp_host": "<string>",
"smtp_port": 32768,
"smtp_username": "<string>",
"smtp_password": "<string>",
"imap_host": "<string>",
"imap_port": 32768,
"imap_username": "<string>",
"imap_password": "<string>",
"daily_limit": 100,
"smtp_use_tls": True,
"imap_use_ssl": True
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
inboxes: [
{
email_address: '<string>',
display_name: '<string>',
inbox_type: '<string>',
smtp_host: '<string>',
smtp_port: 32768,
smtp_username: '<string>',
smtp_password: '<string>',
imap_host: '<string>',
imap_port: 32768,
imap_username: '<string>',
imap_password: '<string>',
daily_limit: 100,
smtp_use_tls: true,
imap_use_ssl: true
}
]
})
};
fetch('https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'inboxes' => [
[
'email_address' => '<string>',
'display_name' => '<string>',
'inbox_type' => '<string>',
'smtp_host' => '<string>',
'smtp_port' => 32768,
'smtp_username' => '<string>',
'smtp_password' => '<string>',
'imap_host' => '<string>',
'imap_port' => 32768,
'imap_username' => '<string>',
'imap_password' => '<string>',
'daily_limit' => 100,
'smtp_use_tls' => true,
'imap_use_ssl' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk"
payload := strings.NewReader("{\n \"inboxes\": [\n {\n \"email_address\": \"<string>\",\n \"display_name\": \"<string>\",\n \"inbox_type\": \"<string>\",\n \"smtp_host\": \"<string>\",\n \"smtp_port\": 32768,\n \"smtp_username\": \"<string>\",\n \"smtp_password\": \"<string>\",\n \"imap_host\": \"<string>\",\n \"imap_port\": 32768,\n \"imap_username\": \"<string>\",\n \"imap_password\": \"<string>\",\n \"daily_limit\": 100,\n \"smtp_use_tls\": true,\n \"imap_use_ssl\": true\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"inboxes\": [\n {\n \"email_address\": \"<string>\",\n \"display_name\": \"<string>\",\n \"inbox_type\": \"<string>\",\n \"smtp_host\": \"<string>\",\n \"smtp_port\": 32768,\n \"smtp_username\": \"<string>\",\n \"smtp_password\": \"<string>\",\n \"imap_host\": \"<string>\",\n \"imap_port\": 32768,\n \"imap_username\": \"<string>\",\n \"imap_password\": \"<string>\",\n \"daily_limit\": 100,\n \"smtp_use_tls\": true,\n \"imap_use_ssl\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inboxes\": [\n {\n \"email_address\": \"<string>\",\n \"display_name\": \"<string>\",\n \"inbox_type\": \"<string>\",\n \"smtp_host\": \"<string>\",\n \"smtp_port\": 32768,\n \"smtp_username\": \"<string>\",\n \"smtp_password\": \"<string>\",\n \"imap_host\": \"<string>\",\n \"imap_port\": 32768,\n \"imap_username\": \"<string>\",\n \"imap_password\": \"<string>\",\n \"daily_limit\": 100,\n \"smtp_use_tls\": true,\n \"imap_use_ssl\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "<string>",
"total": 123,
"success_count": 123,
"failed_count": 123,
"job_id": "<string>",
"results": []
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sender Accounts
Add multiple SMTP email accounts
Bulk connect multiple email accounts via SMTP/IMAP
Add multiple email accounts in a single request (max 100). Each account must have valid SMTP/IMAP credentials.
Important Notes
- Maximum 100 inboxes per request
- Connection validation runs in background
- Returns immediately with a job_id for tracking
- Poll the progress endpoint to check status
Tracking Progress
Use the returned job_id to track progress:
GET /api/public/v1/sender-accounts/smtp/bulk/{job_id}/progress
POST
/
api
/
public
/
v1
/
sender-accounts
/
smtp
/
bulk
Add multiple SMTP email accounts
curl --request POST \
--url https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"inboxes": [
{
"email_address": "<string>",
"display_name": "<string>",
"inbox_type": "<string>",
"smtp_host": "<string>",
"smtp_port": 32768,
"smtp_username": "<string>",
"smtp_password": "<string>",
"imap_host": "<string>",
"imap_port": 32768,
"imap_username": "<string>",
"imap_password": "<string>",
"daily_limit": 100,
"smtp_use_tls": true,
"imap_use_ssl": true
}
]
}
'import requests
url = "https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk"
payload = { "inboxes": [
{
"email_address": "<string>",
"display_name": "<string>",
"inbox_type": "<string>",
"smtp_host": "<string>",
"smtp_port": 32768,
"smtp_username": "<string>",
"smtp_password": "<string>",
"imap_host": "<string>",
"imap_port": 32768,
"imap_username": "<string>",
"imap_password": "<string>",
"daily_limit": 100,
"smtp_use_tls": True,
"imap_use_ssl": True
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
inboxes: [
{
email_address: '<string>',
display_name: '<string>',
inbox_type: '<string>',
smtp_host: '<string>',
smtp_port: 32768,
smtp_username: '<string>',
smtp_password: '<string>',
imap_host: '<string>',
imap_port: 32768,
imap_username: '<string>',
imap_password: '<string>',
daily_limit: 100,
smtp_use_tls: true,
imap_use_ssl: true
}
]
})
};
fetch('https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'inboxes' => [
[
'email_address' => '<string>',
'display_name' => '<string>',
'inbox_type' => '<string>',
'smtp_host' => '<string>',
'smtp_port' => 32768,
'smtp_username' => '<string>',
'smtp_password' => '<string>',
'imap_host' => '<string>',
'imap_port' => 32768,
'imap_username' => '<string>',
'imap_password' => '<string>',
'daily_limit' => 100,
'smtp_use_tls' => true,
'imap_use_ssl' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk"
payload := strings.NewReader("{\n \"inboxes\": [\n {\n \"email_address\": \"<string>\",\n \"display_name\": \"<string>\",\n \"inbox_type\": \"<string>\",\n \"smtp_host\": \"<string>\",\n \"smtp_port\": 32768,\n \"smtp_username\": \"<string>\",\n \"smtp_password\": \"<string>\",\n \"imap_host\": \"<string>\",\n \"imap_port\": 32768,\n \"imap_username\": \"<string>\",\n \"imap_password\": \"<string>\",\n \"daily_limit\": 100,\n \"smtp_use_tls\": true,\n \"imap_use_ssl\": true\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"inboxes\": [\n {\n \"email_address\": \"<string>\",\n \"display_name\": \"<string>\",\n \"inbox_type\": \"<string>\",\n \"smtp_host\": \"<string>\",\n \"smtp_port\": 32768,\n \"smtp_username\": \"<string>\",\n \"smtp_password\": \"<string>\",\n \"imap_host\": \"<string>\",\n \"imap_port\": 32768,\n \"imap_username\": \"<string>\",\n \"imap_password\": \"<string>\",\n \"daily_limit\": 100,\n \"smtp_use_tls\": true,\n \"imap_use_ssl\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coldsend.pro/api/public/v1/sender-accounts/smtp/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inboxes\": [\n {\n \"email_address\": \"<string>\",\n \"display_name\": \"<string>\",\n \"inbox_type\": \"<string>\",\n \"smtp_host\": \"<string>\",\n \"smtp_port\": 32768,\n \"smtp_username\": \"<string>\",\n \"smtp_password\": \"<string>\",\n \"imap_host\": \"<string>\",\n \"imap_port\": 32768,\n \"imap_username\": \"<string>\",\n \"imap_password\": \"<string>\",\n \"daily_limit\": 100,\n \"smtp_use_tls\": true,\n \"imap_use_ssl\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "<string>",
"total": 123,
"success_count": 123,
"failed_count": 123,
"job_id": "<string>",
"results": []
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
API key with format cs_live_xxx
Body
application/json
Request for bulk creating SMTP inboxes.
List of SMTP inboxes to create (max 100)
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Response
Bulk SMTP inbox creation initiated
Response for bulk SMTP inbox creation.
Total inboxes in request
Number of successfully created inboxes
Number of failed creations
Job ID for tracking progress
Individual creation results
Show child attributes
Show child attributes
Was this page helpful?
⌘I

