Update Domain Redirect
POST
https://server.scaledmail.com/api/v1/swap-redirect/{domain}
↪️ Use this endpoint to update (or remove) the redirect URL for an existing domain.
⚠️ This creates a pending request, same as /swap-domainand/swap-sender-name— it does not take effect immediately. Our team reviews and applies it.
🔑 Authentication
POST /api/v1/swap-redirect/:old_domain🔑 Path Parameters
old_domain (required)
🔑 Query Parameters
organization_id (required)
📥 Request Body Parameters
new_redirect (required)
{ "new_redirect": "https://mybrand.com/landing" }new_redirect key must be present in the body — omitting it entirely returns an error.https:// is added automatically if you omit the protocol (e.g. "mybrand.com" becomes "https://mybrand.com")."") or null to remove the domain's existing redirect.📋 Example Requests
Example 1 — Set a new redirect
POST /api/v1/swap-redirect/outreach-one.com?organization_id=recXXXXXXXXXXXXXX{
"new_redirect": "mybrand.com/landing"
}Example 2 — Remove an existing redirect
POST /api/v1/swap-redirect/outreach-one.com?organization_id=recXXXXXXXXXXXXXX{
"new_redirect": ""
}✅ Response
{
"message": "Redirect Swap Requested"
}⚠️ Error Responses
Missing new_redirect
{ "error": "new_redirect is required" }Invalid domain format
{ "error": "Invalid domain format" }Invalid redirect format
{ "error": "Invalid redirect format" }Domain not found
{ "error": "Domain not found" }Domain uses Domain Masking
{ "error": "Domain outreach-one.com is using Domain Masking, not a plain redirect -- use POST /swap-domain-masking/outreach-one.com instead" }Same redirect
{ "error": "Cannot use same redirect" }Conflicting pending request already exists
{ "error": "Cannot create domain swap request. Domain \"outreach-one.com\" already has a pending Redirect URL change request (Status: New Order)" }ℹ️ Notes
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-redirect/?organization_id=undefined' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: text/plain' \
--data '{
"new_redirect":"scaledmail.com"
}'Response Response Example
{}Modified at 2026-09-21 11:16:57