Domains

import { YourMail } from "yourmail";

const yourmail = new YourMail(process.env.YOURMAIL_API_KEY!);

// Add the domain and get its DNS records in the same call.
const domain = await yourmail.domains.create("mail.acme.com");
for (const r of domain.dnsRecords) {
  console.log(r.type, r.name, r.value);
}

// Verification runs on its own once the records are live — poll if you like.
const { status } = await yourmail.domains.get(domain.id); // "pending" -> "verified"

# Add
curl -X POST https://api.yourmail.dev/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.acme.com" }'

# List / get / remove
curl https://api.yourmail.dev/v1/domains -H "Authorization: Bearer YOUR_API_KEY"
curl https://api.yourmail.dev/v1/domains/DOMAIN_ID -H "Authorization: Bearer YOUR_API_KEY"
curl -X DELETE https://api.yourmail.dev/v1/domains/DOMAIN_ID -H "Authorization: Bearer YOUR_API_KEY"

// 201 Created (POST) — the same shape GET returns
{
  "id": "jd7abc...",
  "name": "mail.acme.com",
  "status": "pending",
  "verifiedAt": null,
  "createdAt": 1756800000000,
  "dnsHost": "cloudflare",
  "dnsRecords": [
    {
      "type": "CNAME",
      "name": "abc._domainkey.mail.acme.com",
      "value": "abc.dkim.amazonses.com",
      "found": null,
      "observed": null
    }
  ],
  "recommendedRecords": [
    {
      "type": "TXT",
      "name": "_dmarc.mail.acme.com",
      "value": "v=DMARC1; p=none;",
      "found": null,
      "observed": null
    }
  ],
  "failureReason": null,
  "dnsCheckedAt": null,
  "dnsRegressedAt": null,
  "suspendedAt": null,
  "trackEngagement": true
}