Skip to main content
POST
Buy a pre-warmed domain

Authorizations

Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json

Same shape and rules for the estimate and the purchase, so one body can be posted to both.

serviceProvider
enum<string>
required

Mailbox provider the bundle is listed with, case-insensitive. Must be the provider the domain was found under — a bundle is not visible to the other one.

Available options:
Google,
Microsoft
domain
object
required

Response

Order accepted; poll the returned job for the outcome

jobId
string<uuid>
required

Poll GET /v3/background-jobs/{jobId} for the outcome