Create Inbox

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

curl -X POST https://api.usenaive.ai/v1/email/inboxes \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "local_part": "support"
  }'

{
  "id": "uuid",
  "address": "support@acme-corp.ai",
  "local_part": "support",
  "domain": "acme-corp.ai",
  "status": "active",
  "created_at": "2025-01-15T10:30:00Z"
}

​

What this does

1. Validates the local_part (sanitizes to lowercase, strips invalid chars)
2. Finds the target domain (provided or company’s default active domain)
3. Checks that the resulting address doesn’t already exist
4. Creates the inbox record
5. Returns the inbox UUID for immediate use in POST /v1/email/send

​

Requirements

• Company must have at least one active domain
• The address must not already be taken (active)
• local_part minimum 2 characters after sanitization

​

Error responses

​

CLI

naive email create --local-part support
naive email create --local-part sales-team --domain-id <uuid>

​

MCP

{
  "local_part": "support",
  "domain_id": "optional-uuid"
}