Create Email Domain

Create an email domain configuration for sending.

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

201 Created

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