Update Domain Name
POST
https://server.scaledmail.com/api/v1/swap-domain/{domain}
🔑 Query Parameters
domain (required):The old domain name you want to swap out.
provider (required):Specifies the source of the new domain:
→
"scaledmail" — Domain purchased through ScaledMail→
"other" — Domain from external providers like Porkbun, Namecheap, or DNSimple📥 Request Body Parameters
new_domain (required):The name of the new domain you want to assign.
→ This can be either a third-party domain (external) or an available purchased domain retrieved from the
/purchased-domains endpoint.hosting (conditionally required):Required only when
provider = "other" (i.e., for third-party domains).→ Not required if
provider = "scaledmail" — ScaledMail handles hosting automatically.Request
Path Params
Query Params
Body Params text/plain
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://server.scaledmail.com/api/v1/swap-domain/?organization_id&provider' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: text/plain' \
--data-raw '{
"hosting": {
"provider": "Hosting Provier Name Here",
"username": "username",
"password": "password"
},
"new_domain":"scaledmailgo.com",
}'Response Response Example
{}Modified at 2026-01-30 14:18:23