Update Domain Masking
POST
https://server.scaledmail.com/api/v1/swap-domain-masking/{domain}
đ Use this endpoint to request a change to which domain a Domain Masking proxy points to.
â ī¸ This creates a pending request, same as /swap-domainand/swap-redirectâ it does not take effect immediately. Our team reviews and applies it.
đ Authentication
POST /api/v1/swap-domain-masking/:old_domainđ Path Parameters
old_domain (required)
đ Query Parameters
organization_id (required)
đĨ Request Body Parameters
new_primary_domain (required)
{ "new_primary_domain": "newbrand.com" }primary_domain.đ Example Request
POST /api/v1/swap-domain-masking/mask-one.com?organization_id=recXXXXXXXXXXXXXX{
"new_primary_domain": "newbrand.com"
}â Response
{
"message": "Domain Masking Swap Requested"
}â ī¸ Error Responses
Invalid domain format
{ "error": "Invalid domain format" }Missing new_primary_domain
{ "error": "new_primary_domain is required" }Domain masking proxy not found
{ "error": "Domain masking proxy not found" }Same primary domain
{ "error": "Cannot use same primary domain" }Conflicting pending request already exists
{ "error": "Cannot create domain swap request. Domain \"mask-one.com\" already has a pending Domain Masking change request (Status: New Order)" }âšī¸ Notes
primary_domain before requesting a change./swap-redirect on a masked domain â it will reject the request and tell you to use this endpoint instead.Request
Path Params
Query Params
Body Params text/plain
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://server.scaledmail.com/api/v1/swap-domain-masking/?organization_id=undefined' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: text/plain' \
--data '{
"new_redirect":"scaledmail.com"
}'Response Response Example
{}Modified at 2026-10-03 15:41:35