curl -X POST "https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 90 \
  -d '{
    "domain": "example.com",
    "order_id": "SS-1712345678901-4242-1",
    "mailboxes": [
      { "mailbox": "jane", "first_name": "Jane", "last_name": "Doe" },
      {
        "mailbox": "sam@example.com",
        "first_name": "Sam",
        "last_name": "Lee",
        "profile_pic": "https://example.com/sam.jpg"
      }
    ]
  }'

import requests

API_KEY = "YOUR_API_KEY"

payload = {
    "domain": "example.com",
    "order_id": "SS-1712345678901-4242-1",
    "mailboxes": [
        {"mailbox": "jane", "first_name": "Jane", "last_name": "Doe"},
        {
            "mailbox": "sam@example.com",
            "first_name": "Sam",
            "last_name": "Lee",
            "profile_pic": "https://example.com/sam.jpg",
        },
    ],
}

response = requests.post(
    "https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain",
    params={"api_key": API_KEY},
    json=payload,
    timeout=90,  # allow at least 60 seconds
)

result = response.json()
if response.status_code == 201:
    print(f"Added {result['data']['quantity']} mailboxes: {result['data']['mailboxes']}")
else:
    print(f"{response.status_code} {result.get('code')}: {result.get('message')}")

const API_KEY = 'YOUR_API_KEY';

const payload = {
  domain: 'example.com',
  order_id: 'SS-1712345678901-4242-1',
  mailboxes: [
    { mailbox: 'jane', first_name: 'Jane', last_name: 'Doe' },
    {
      mailbox: 'sam@example.com',
      first_name: 'Sam',
      last_name: 'Lee',
      profile_pic: 'https://example.com/sam.jpg'
    }
  ]
};

const response = await fetch(
  `https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain?api_key=${API_KEY}`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(payload),
    signal: AbortSignal.timeout(90000) // allow at least 60 seconds
  }
);

const result = await response.json();
if (response.status === 201) {
  console.log(`Added ${result.data.quantity} mailboxes:`, result.data.mailboxes);
} else {
  console.log(`${response.status} ${result.code}: ${result.message}`);
}

{
  "status": "ORDER_PLACEMENT_SUCCESS",
  "order_id": "SS-1712345678901-4242-1",
  "data": {
    "order_id": "SS-1712345678901-4242-1",
    "domain_id": 12345,
    "domain_name": "example.com",
    "quantity": 2,
    "mailbox_count_after": 4,
    "mailboxes": ["jane@example.com", "sam@example.com"]
  }
}

{
  "status": "error",
  "code": "INVALID_MAILBOX",
  "message": "Mailbox jane..doe is not a valid email local part"
}

{
  "message": "Invalid API Key"
}

{
  "status": "error",
  "code": "DOMAIN_NOT_FOUND",
  "message": "We couldn't find example.com on order SS-1712345678901-4242-1 on your account. Check the domain name and the id of the order it was bought under."
}

{
  "status": "error",
  "code": "MAILBOX_LIMIT_EXCEEDED",
  "message": "A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested"
}

{
  "status": "error",
  "code": "DOMAIN_FULL_PENDING_DELETION",
  "message": "Domain example.com has no free mailbox slots because 1 mailbox is pending deletion. Permanently delete one to free a slot.",
  "pending_mailboxes": [
    {
      "id": 987654,
      "from_email": "old@example.com",
      "scheduled_delete_at": "2026-11-02T00:00:00.000Z"
    }
  ]
}

{
  "status": "error",
  "code": "ADD_MAILBOXES_IN_PROGRESS",
  "message": "Mailboxes are already being added to this domain. Wait for that request to finish before retrying."
}

{
  "status": "error",
  "code": "ADD_MAILBOXES_STATUS_UNKNOWN",
  "message": "We couldn't confirm whether these mailboxes were added. To avoid being billed twice, check order SS-1712345678901-4242-1 in a few minutes before retrying."
}