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": 2,
    "forwarding_domain": "example.com",
    "user_details": {
      "email": "manjit@example.com",
      "firstName": "Manjit",
      "lastName": "Singh",
      "company": "Smartlead",
      "country": "India",
      "city": "Bangalore",
      "addressLineOne": "123 MG Road",
      "addressLineTwo": "",
      "postalCode": "560001",
      "state": "Karnataka",
      "phoneCc": "+91",
      "phone": "9876543210",
      "languagePreference": "en"
    },
    "domains": [
      {
        "domain_name": "example.com",
        "mailbox_details": [
          {
            "mailbox": "manjit.singh@example.com",
            "first_name": "Manjit",
            "last_name": "Singh",
            "profile_pic": "profile1.jpg",
            "parent_account_id": 123
          },
          {
            "mailbox": "singh@example.com",
            "first_name": "Manjit",
            "last_name": "Singh",
            "profile_pic": "profile2.jpg"
          }
        ]
      },
      {
        "domain_name": "testdomain.com",
        "mailbox_details": [
          {
            "mailbox": "john.doe@testdomain.com",
            "first_name": "John",
            "last_name": "Doe",
            "profile_pic": "profile3.jpg"
          }
        ]
      }
    ]
  }'

{
  "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.
​
forwarding_domain
string
required
Domain to which purchased domains will be configured to forward (e.g., example.com or customer’s tracking domain).
​
user_details
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)
​
domains
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

​
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": 2,
    "forwarding_domain": "example.com",
    "user_details": {
      "email": "manjit@example.com",
      "firstName": "Manjit",
      "lastName": "Singh",
      "company": "Smartlead",
      "country": "India",
      "city": "Bangalore",
      "addressLineOne": "123 MG Road",
      "addressLineTwo": "",
      "postalCode": "560001",
      "state": "Karnataka",
      "phoneCc": "+91",
      "phone": "9876543210",
      "languagePreference": "en"
    },
    "domains": [
      {
        "domain_name": "example.com",
        "mailbox_details": [
          {
            "mailbox": "manjit.singh@example.com",
            "first_name": "Manjit",
            "last_name": "Singh",
            "profile_pic": "profile1.jpg",
            "parent_account_id": 123
          },
          {
            "mailbox": "singh@example.com",
            "first_name": "Manjit",
            "last_name": "Singh",
            "profile_pic": "profile2.jpg"
          }
        ]
      },
      {
        "domain_name": "testdomain.com",
        "mailbox_details": [
          {
            "mailbox": "john.doe@testdomain.com",
            "first_name": "John",
            "last_name": "Doe",
            "profile_pic": "profile3.jpg"
          }
        ]
      }
    ]
  }'

​
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": []
}