Create Inbox

curl -X POST https://api.daimon.email/v1/inboxes \
  -H "Content-Type: application/json" \
  -d '{
    "username": "my-agent",
    "display_name": "My AI Agent",
    "client_id": "unique-idempotency-key-123"
  }'

import { DaimonClient } from 'daimon-email';

const client = new DaimonClient();

const inbox = await client.inboxes.create({
  username: 'my-agent',
  displayName: 'My AI Agent',
  clientId: 'unique-idempotency-key-123'
});

console.log(`Created: ${inbox.address}`);
console.log(`Inbox API Key: ${inbox.apiKey}`);
console.log(`Account API Key: ${inbox.accountApiKey}`);

from daimon_email import DaimonClient

client = DaimonClient()

inbox = client.inboxes.create(
    username="my-agent",
    display_name="My AI Agent",
    client_id="unique-idempotency-key-123"
)

print(f"Created: {inbox.address}")
print(f"Inbox API Key: {inbox.api_key}")
print(f"Account API Key: {inbox.account_api_key}")

{
  "result": {
    "id": "inb_abc123def456",
    "address": "my-agent@daimon.email",
    "api_key": "dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o",
    "account_api_key": "dm_free_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "display_name": "My AI Agent",
    "status": "active",
    "tier": "free",
    "view_url": "https://daimon.email/inbox/inb_abc123def456?key=dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o",
    "created_at": "2026-03-16T12:34:56Z"
  },
  "next_steps": [
    "Save the api_key to authenticate requests for this inbox",
    "Save the account_api_key to list all inboxes or check capabilities",
    "Call GET /v1/inboxes/{id}/messages to poll for incoming messages",
    "Call POST /v1/webhooks to receive real-time notifications"
  ]
}

{
  "result": {
    "id": "inb_abc123def456",
    "address": "my-agent@daimon.email",
    "api_key": "dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o",
    "account_api_key": "dm_free_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "display_name": "My AI Agent",
    "status": "active",
    "tier": "free",
    "view_url": "https://daimon.email/inbox/inb_abc123def456?key=dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o",
    "created_at": "2026-03-16T12:34:56Z"
  },
  "next_steps": [
    "This inbox was created previously with the same client_id",
    "Use the existing api_key to authenticate requests"
  ]
}

{
  "error": "INVALID_USERNAME",
  "message": "Username must be 3-32 characters, lowercase alphanumeric and hyphens only",
  "next_steps": [
    "Choose a username between 3-32 characters",
    "Use only lowercase letters, numbers, and hyphens",
    "Ensure username starts and ends with alphanumeric character"
  ]
}

{
  "error": "USERNAME_TAKEN",
  "message": "The username 'my-agent' is already taken",
  "next_steps": [
    "Try a different username",
    "Add a suffix like 'my-agent-2' or 'my-agent-prod'"
  ]
}