---
title: "Create Mailbox"
method: POST
path: "/mailbox"
tags: ["Mailbox"]
---

# Create Mailbox

`POST /mailbox`

Create new mabl Mailbox address

## Request body

- CreatePermanentMailboxRequest — Request body for creating a new Mailbox
  - `workspace_id` string, required — ID of Workspace in which to create Mailbox
  - `address_prefix` string — Desired prefix before UID and domain
  - `name` string — Mailbox name
  - `description` string — Mailbox description

## Response `201`

Mailbox created

- Mailbox
  - `id` string
  - `email_address` string — Email address to be used in Mailbox steps
  - `context_id` string — Context ID for which email address is being generated
  - `created_time` integer — Time Mailbox was created
  - `created_by_id` string — ID of user who created Mailbox
  - `last_updated_time` integer — Time Mailbox was last updated
  - `last_updated_by_id` string — ID of user who last updated Mailbox
  - `workspace_id` string
  - `name` string — Email address name (permanent emails only)
  - `description` string — Email address description (permanent emails only)
  - `lifespan` 'permanent' | 'variable' — Defines how long email address will be accessible. Permanent Mailboxes are always accessible. Variable Mailboxes are accessible only during a single context (test run / training session). Note that accessibility here refers to the email address itself, not the contents of the Mailbox. When undefined, defaults to variable.
  - `disabled_time` integer — Time Mailbox was disabled. If null, the Mailbox is enabled.

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `409` — Unknown error
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)