Skip to main content
POST
Smart Senders API: Mailbox marketplace feature. Contact support@smartlead.ai for access.

​
Query Parameters

​
string
required
API key used to authenticate and authorise the request.

​
Body Parameters

​
integer
required
Unique identifier of the vendor with whom the order will be placed.
​
string
required
Domain to which purchased domains will be configured to forward (e.g., example.com or customer’s tracking domain).
​
object
required
Customer billing/contact details required by the vendor for domain purchase and provisioning. Fields include:
  • email (string) — Contact email
  • firstName (string) — First name
  • lastName (string) — Last name
  • company (string) — Company name
  • country (string) — Country
  • city (string) — City
  • addressLineOne (string) — Primary address
  • addressLineTwo (string) — Secondary address (optional)
  • postalCode (string) — Postal/ZIP code
  • state (string) — State/province
  • phoneCc (string) — Phone country code (e.g., +91)
  • phone (string) — Phone number
  • languagePreference (string) — Language preference (e.g., en)
​
array
required
Array of domain objects. Each object contains:
  • domain_name (string) — The domain to purchase
  • mailbox_details (array) — Array of mailbox objects, each containing:
    • mailbox (string, required) — Full email address for the mailbox
    • first_name (string, required) — First name for the mailbox
    • last_name (string, required) — Last name for the mailbox
    • profile_pic (string) — Profile picture filename
    • parent_account_id (number) — ID of the parent email account to link to (optional)

​
Headers

​
string
Must be application/json

​
Response Codes

​
Success
Order placed successfully. Returns order confirmation details.
​
Bad Request
Invalid request parameters or malformed request body
​
Unauthorized
Invalid or missing API key. Check your authentication.
​
Internal Server Error
Server error occurred. Please try again or contact support if the issue persists.