{
  "type": "https://errors.swepay.com.br/native-mail/domain-already-registered",
  "service": "native-mail",
  "slug": "domain-already-registered",
  "httpStatus": 409,
  "title": "Domain Already Registered",
  "summary": "The sending domain is already registered for this tenant.",
  "description": "A request to register a sending domain was rejected because that domain is\nalready registered for the tenant. This is a uniqueness conflict on the\n`(tenant, domain)` pair — the request body itself is valid; it conflicts with\nthe current state.\n\nConflicts are about *state*, not input shape. Re-sending the same registration\nwill keep returning `409` until the existing domain is removed.\n",
  "commonCauses": [
    "The domain was already registered by a previous request.",
    "A concurrent request registered the same domain first.",
    "A retry re-sent a registration that had already succeeded."
  ],
  "clientAction": "1. List your registered domains via `GET /v1/domains`.\n2. If the domain already exists, reuse it (check its verification status)\n   instead of registering it again.\n3. To re-register from scratch, remove it first via\n   `DELETE /v1/domains/{domain}`, then `POST /v1/domains`.\n",
  "exampleResponse": {
    "type": "https://errors.swepay.com.br/native-mail/domain-already-registered",
    "title": "Domain Already Registered",
    "status": 409,
    "detail": "Domain 'mail.empresa.com.br' is already registered for tenant 'acme'.",
    "instance": "/v1/domains",
    "code": "DOMAIN_ALREADY_REGISTERED",
    "recovery": "Use the existing domain or remove it before registering it again.",
    "requestId": "1-67a8c3f1-2b9e4d6a8c1f0e3b"
  },
  "relatedDocs": [
    {
      "label": "RFC 9457 — Problem Details",
      "url": "https://www.rfc-editor.org/rfc/rfc9457"
    }
  ],
  "category": "service",
  "deprecated": false,
  "documentation": "https://errors.swepay.com.br/native-mail/domain-already-registered"
}