Domains API

Parent API: Tenant SMTP API URL Prefix: /api/v1/tenant/smtp

---

Endpoints

Get Tenant SMTP Configuration

Method: GET URL: /api/v1/tenant/smtp/config Purpose: Retrieve effective SMTP configuration and domain verification status.

Response:

{
  "success": true,
  "data": {
    "tenant_id": "tn_123",
    "from_domains": [
      {
        "domain": "example.com",
        "dkim_status": "verified",
        "spf_status": "verified",
        "dmarc_status": "configured"
      }
    ],
    "rate_limits": {
      "max_per_hour": 20000
    }
  }
}

Add Domain

Method: POST URL: /api/v1/tenant/smtp/domains Purpose: Register a new sending domain.

Request:

{
  "domain": "marketing.example.com"
}

Get DNS Records

Method: GET URL: /api/v1/tenant/smtp/domains/{domain}/dns Purpose: Retrieve required DNS records for verification.