Skip to main content

​
Method

POST /v1/comms/email-domains

​
Body Parameters

​
domainId
uuid
required
Managed domain identifier
​
returnPathDomain
string
Return-path/bounce domain
​
trackingDomain
string
Click/open tracking domain
​
dmarcPolicy
string
DMARC policy (e.g., none, quarantine, reject)

​
Headers

​
Authorization
string
required
Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)
​
content-type
string
application/json

​
Request Example

cURL
curl -X POST https://api.voyantcloud.com/v1/comms/email-domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "domainId": "0d85c2d7-1111-2222-3333-abcdefabcdef",
    "returnPathDomain": "bounces.example.com",
    "trackingDomain": "trk.example.com",
    "dmarcPolicy": "quarantine"
  }'
Node.js
await fetch("https://api.voyantcloud.com/v1/comms/email-domains", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.VOYANT_API_KEY}`, "content-type": "application/json" },
  body: JSON.stringify({ domainId: "0d85c2d7-1111-2222-3333-abcdefabcdef" }),
})
Python
import os, requests
requests.post(
  "https://api.voyantcloud.com/v1/comms/email-domains",
  headers={"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}", "content-type": "application/json"},
  json={"domainId": "0d85c2d7-1111-2222-3333-abcdefabcdef"},
)

​
Response

{
  "id": "emd_123",
  "domainId": "0d85c2d7-1111-2222-3333-abcdefabcdef",
  "provider": null,
  "returnPathDomain": null,
  "trackingDomain": null,
  "dmarcPolicy": null
}