Create Order
Deprecated
POST
/orders
Confirmation behavior
confirm: true — order is queued immediately and returns 200.confirm omitted — order is saved as a draft and returns 201. Process the draft later via POST /orders/process-order.Partial success
metadata object in the response contains per-domain results.Note: Use POST /orders/jsonfor a JSON-only version without file upload.
Request
Query Params
Body Params multipart/form-dataRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://customers.coldmailreseller.com/api/v1/integration/orders?userId=H8M9JV2S9HMPYFQW393AZHQVD4XM' \
--header 'cmr-x-api-key: <api-key>' \
--form 'domains="[{\"domain\":\"acmecorp.com\",\"years\":1}]"' \
--form 'mailboxes="{\"acmecorp.com\":[{\"username\":\"alice\",\"firstName\":\"Alice\",\"lastName\":\"Johnson\"}]}"' \
--form 'billingCycle="MONTHLY"' \
--form 'serviceProvider="GOOGLE"' \
--form 'autoRenew="true"' \
--form 'confirm="true"' \
--form 'google="{\"googleOauthRoute\":\"https://yourapp.com/oauth/google/callback\",\"clientId\":\"client-id\",\"appName\":\"MyApp\"}"' \
--form 'microsoftOauthRoute="https://yourapp.com/oauth/microsoft/callback"' \
--form '{username}@{domainName}=@""'Response Response Example
200 - Example 1
{
"status": 200,
"message": "Order created and queued for processing",
"data": {
"orderId": "ord_R8K2LQPZA9XM",
"metadata": {
"property1": "Success",
"property2": "Success"
}
},
"actionId": "ACT_7a078272-0fa7-4db4-a85b-c78697dacea1"
}Modified at 2026-08-06 06:20:56