Lumbox Docs

Inboxes

Create and manage email inboxes for your agents.

Inboxes

Inboxes are email addresses your agents use. Each inbox gets a real address like name@lumbox.co.

Create Inbox

POST /v1/inboxes
FieldTypeRequiredDescription
namestringNoName for the inbox (used as email local part)
domainstringNoCustom domain (defaults to lumbox.co)
curl -X POST https://api.lumbox.co/v1/inboxes \
  -H "X-API-Key: ak_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "github-bot"}'
{
  "id": "inb_abc123",
  "address": "github-bot@lumbox.co",
  "name": "github-bot",
  "domain": "lumbox.co",
  "created_at": "2025-01-01T00:00:00.000Z"
}

List Inboxes

GET /v1/inboxes

Returns all inboxes in your organization.

Get Inbox

GET /v1/inboxes/:id

Delete Inbox

DELETE /v1/inboxes/:id

Permanently deletes the inbox and all its emails.