curl --request POST \
--url https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"serviceProvider": "Google",
"domain": {
"domainName": "trademomentum.co",
"forwardTo": "https://example.com"
}
}
'import requests
url = "https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase"
payload = {
"serviceProvider": "Google",
"domain": {
"domainName": "trademomentum.co",
"forwardTo": "https://example.com"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
serviceProvider: 'Google',
domain: {domainName: 'trademomentum.co', forwardTo: 'https://example.com'}
})
};
fetch('https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'serviceProvider' => 'Google',
'domain' => [
'domainName' => 'trademomentum.co',
'forwardTo' => 'https://example.com'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase"
payload := strings.NewReader("{\n \"serviceProvider\": \"Google\",\n \"domain\": {\n \"domainName\": \"trademomentum.co\",\n \"forwardTo\": \"https://example.com\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"serviceProvider\": \"Google\",\n \"domain\": {\n \"domainName\": \"trademomentum.co\",\n \"forwardTo\": \"https://example.com\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"serviceProvider\": \"Google\",\n \"domain\": {\n \"domainName\": \"trademomentum.co\",\n \"forwardTo\": \"https://example.com\"\n }\n}"
response = http.request(request)
puts response.read_body{
"jobId": "3f2b9c1e-5d47-4a8b-9f10-2c6de8a71b34"
}Buy a pre-warmed domain
New. This endpoint shipped recently. If anything about it is unclear or could work better for you, tell us in the developer Slack.
channels:write scope (or a broader one that includes it).
Buys one pre-warmed bundle: the domain and every mailbox already warming on it. A bundle is sold whole — you cannot pick a subset of its mailboxes, and you cannot add more in the same order.
Send serviceProvider and domain.domainName exactly as the available pre-warmed domains list returns them. Price the order first with the estimate: this endpoint charges the card on file.
Returns a jobId and a Location header — poll GET /v3/background-jobs/ for the outcome. On success its jsonDataResult carries the registered domain and the mailboxes that came with it, each with its e-mail, username and name.
Two purchases of the same domain by the same team inside 24 hours are refused rather than charged twice, and the detail carries the job reference of the first one: 409 when the first purchase is still running or was placed, and the first job’s own 502 or 503 when it failed after the payment step.
When the job ends as Failed, its jsonDataResult carries an errorCode and a message — on domain.failureMessage for preWarmedDomain.domainNotFound, otherwise on the top-level failureMessage. No payment was charged, except for preWarmedDomain.submitFailed and for a preWarmedDomain.temporarilyUnavailable whose message says the payment or the order could not be confirmed.
errorCode | Meaning |
|---|---|
preWarmedDomain.domainNotFound | The bundle is no longer on sale — someone else bought it, or the provider withdrew it. Pick another from the available list. |
preWarmedDomain.validation | The bundle or the current plan cannot take the order. |
preWarmedDomain.paymentDeclined | The payment provider declined the payment. |
preWarmedDomain.paymentActionRequired | The saved payment method needs interactive authentication. Complete it in the app, then retry. |
preWarmedDomain.upstreamBadRequest | The provider rejected the order. Check the domain name and service provider. |
preWarmedDomain.upstreamUnavailable | The provider was unreachable. Retry later. |
preWarmedDomain.temporarilyUnavailable | A transient failure. When the message says no payment was charged, retry. When it says the payment or the order may or may not have gone through, do not retry — contact support with the jobId. |
preWarmedDomain.featureDisabled | Pre-warmed domains were switched off for the team, or dropped from its plan, while the job ran. |
preWarmedDomain.unknown | The order could not be reliably priced, or the inventory could not be checked. Retry, or contact support. |
preWarmedDomain.submitFailed | Payment was taken, but the order reference could not be resolved. Contact support with the jobId before ordering again. |
If the job ends as Expired, nothing reported progress for 26 hours and the job was closed: jsonDataResult is {"timedOut": true}, with no errorCode. The outcome is unknown — the payment may have been taken and the order placed. Do not order again: check GET /v3/email-accounts/procurement/pre-warmed-domains, where the domain appears once the provider accepted the order, and contact support with the jobId if it is not there.
curl --request POST \
--url https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"serviceProvider": "Google",
"domain": {
"domainName": "trademomentum.co",
"forwardTo": "https://example.com"
}
}
'import requests
url = "https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase"
payload = {
"serviceProvider": "Google",
"domain": {
"domainName": "trademomentum.co",
"forwardTo": "https://example.com"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
serviceProvider: 'Google',
domain: {domainName: 'trademomentum.co', forwardTo: 'https://example.com'}
})
};
fetch('https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'serviceProvider' => 'Google',
'domain' => [
'domainName' => 'trademomentum.co',
'forwardTo' => 'https://example.com'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase"
payload := strings.NewReader("{\n \"serviceProvider\": \"Google\",\n \"domain\": {\n \"domainName\": \"trademomentum.co\",\n \"forwardTo\": \"https://example.com\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"serviceProvider\": \"Google\",\n \"domain\": {\n \"domainName\": \"trademomentum.co\",\n \"forwardTo\": \"https://example.com\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reply.io/v3/email-accounts/procurement/pre-warmed-domains/purchase")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"serviceProvider\": \"Google\",\n \"domain\": {\n \"domainName\": \"trademomentum.co\",\n \"forwardTo\": \"https://example.com\"\n }\n}"
response = http.request(request)
puts response.read_body{
"jobId": "3f2b9c1e-5d47-4a8b-9f10-2c6de8a71b34"
}Authorizations
Body
Same shape and rules for the estimate and the purchase, so one body can be posted to both.