Skip to main content
POST
/
api
/
v1
/
smart-senders
/
place-order
curl -X POST "https://smart-senders.smartlead.ai/api/v1/smart-senders/place-order?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_id": 1,
    "domains": [
      {
        "domain_name": "example.com",
        "mailboxes": ["john@example.com", "jane@example.com"]
      }
    ],
    "forwarding_domain": "smartlead.ai",
    "user_details": {
      "name": "John Doe"
    }
  }'

{
  "ok": true,
  "data": []
}
Smart Senders API: Mailbox marketplace feature. Contact support@smartlead.ai for access.

​
Query Parameters

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

​
Body Parameters

​
vendor_id
integer
required
Unique identifier of the vendor with whom the order will be placed.
​
domains
array
required
Array of domain objects. Each object should contain domain_name and an array of mailbox details.
​
forwarding_domain
string
required
Domain to which purchased domains will be configured to forward (e.g., smartlead.ai or customer’s tracking domain).
​
user_details
object
Customer or billing/contact details required by the vendor for domain purchase and provisioning. Includes name and other contact fields.

​
Headers

​
Content-Type
string
Must be application/json
curl -X POST "https://smart-senders.smartlead.ai/api/v1/smart-senders/place-order?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_id": 1,
    "domains": [
      {
        "domain_name": "example.com",
        "mailboxes": ["john@example.com", "jane@example.com"]
      }
    ],
    "forwarding_domain": "smartlead.ai",
    "user_details": {
      "name": "John Doe"
    }
  }'

​
Response Codes

​
200
Success
Order placed successfully. Returns order confirmation details.
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key. Check your authentication.
​
500
Internal Server Error
Server error occurred. Please try again or contact support if the issue persists.
{
  "ok": true,
  "data": []
}