import { CommuneClient } from 'commune-ai';

const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });

const domain = await commune.domains.create({
  domain: 'mycompany.com',
});

console.log(domain.data.id);      // domain ID
console.log(domain.data.status);  // pending

from commune import CommuneClient

client = CommuneClient()

domain = client.domains.create(domain="mycompany.com")

print(domain.data.id)
print(domain.data.status)

create_domain(domain="mycompany.com")

curl -X POST https://api.commune.email/v1/domains \
  -H "Authorization: Bearer comm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "mycompany.com"
  }'

commune domains create --domain "mycompany.com"

{
  "data": {
    "id": "domain_xyz789",
    "name": "mycompany.com",
    "status": "pending",
    "region": "us-east-1",
    "records": [
      {
        "type": "MX",
        "name": "mycompany.com",
        "value": "feedback-smtp.us-east-1.amazonses.com",
        "priority": 10,
        "ttl": 300,
        "status": "not_started"
      },
      {
        "type": "TXT",
        "name": "resend._domainkey.mycompany.com",
        "value": "p=MIGfMA0GCSq...",
        "ttl": 300,
        "status": "not_started"
      }
    ],
    "createdAt": "2026-02-25T10:00:00.000Z"
  }
}

{
  "error": "Missing required field: name"
}

{
  "error": "Custom domain limit reached (1/1). Upgrade your plan for more.",
  "current_count": 1,
  "limit": 1,
  "current_tier": "free",
  "upgrade_url": "/dashboard/billing"
}

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}