# POST /api/v1/email/accounts

> Create a mailbox

- Group: email
- Tier: W
- Required scope: write:email
- Docs: https://api.inleed.com/reference/email/create-mailbox

## Description

Creates `address` with `password` and an optional `quota_mb` (omit or `0` for unlimited). Set the quota later with `set_mailbox_quota`, the password with `set_mailbox_password`.

## Body

- `input` — string. The MCP schema no longer offers input. Up to 255 characters.
- `address` — string (required). The full email address to create, e.g. sales@example.com.
- `password` — string (required). The mailbox password (minimum 8 characters). Whatever you pass here is shown to the customer on the action card automatically, behind a Reveal button — so do not repeat it in your prose, and do not call it temporary (it is the real password until they change it).
- `quota_mb` — integer. Disk quota in megabytes. Omit for the default, or send 0 for unlimited. Range 0–1048576.

## Request

```bash
curl -X POST "https://mcp.inleed.com/api/v1/email/accounts" \
  -H "Authorization: Bearer inl_live_…" \
  -H "Content-Type: application/json" \
  -d '{"input":"example.se","address":"info@example.se","password":"example.se","quota_mb":3}'
```

## Response · 200

```json
{
  "target": {
    "input": "example.se",
    "kind": "domain",
    "domain": null,
    "mailbox": null,
    "serviceId": 90714,
    "domainServiceId": null,
    "daUsername": "inleed42",
    "node": "web12",
    "userId": 4821,
    "note": null
  },
  "address": "info@example.se",
  "quotaMb": 3,
  "sendLimit": 3,
  "created": true
}
```

## Errors

- **400**  — codes: invalid_request
- **401** No token was presented, or the token is revoked, expired or unknown. — codes: unauthorized, token_expired, token_revoked
- **403** The token lacks a required scope, or this account does not own the resource. — codes: insufficient_scope, domain_not_owned
- **404** No such resource for this account. — codes: not_found
- **422** Validation error — codes: validation_failed, password_too_weak
- **429** The rate limit for this token is exhausted. See `Retry-After`. — codes: rate_limited
- **500** Something went wrong on our side. The failure is logged against `requestId`. — codes: internal_error

## Related

- GET /api/v1/email/accounts — https://api.inleed.com/reference/email/list-mailboxes
- PUT /api/v1/email/accounts/password — https://api.inleed.com/reference/email/set-mailbox-password
- PATCH /api/v1/email/accounts/quota — https://api.inleed.com/reference/email/set-mailbox-quota