import { CommuneClient } from 'commune-ai';

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

const inbox = await commune.inboxes.create({
  localPart: 'support',
  name: 'Support Agent',
  domainId: 'domain_xyz789',
});

console.log(inbox.data.address);  // support@mycompany.com
console.log(inbox.data.id);       // uuid

from commune import CommuneClient

client = CommuneClient()

inbox = client.inboxes.create(
    local_part="support",
    name="Support Agent",
    domain_id="domain_xyz789",
)

print(inbox.data.address)  # support@mycompany.com

create_inbox(
  local_part="support",
  name="Support Agent"
)

curl -X POST https://api.commune.email/v1/inboxes \
  -H "Authorization: Bearer comm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "local_part": "support",
    "name": "Support Agent",
    "domain_id": "domain_xyz789"
  }'

commune inboxes create --local-part "support" --name "Support Agent" --domain-id "domain_xyz789"

{
  "data": {
    "id": "3d4f5a6b-7c8d-9e0f-a1b2-c3d4e5f6a7b8",
    "localPart": "support",
    "address": "support@mycompany.com",
    "displayName": "Support Agent",
    "agent": {
      "name": "Support Agent"
    },
    "status": "active",
    "createdAt": "2026-02-25T10:00:00.000Z",
    "domain_id": "domain_xyz789",
    "domain_name": "mycompany.com"
  }
}

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

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

{
  "error": "Domain not found"
}