# Make a mailbox on a verified domain

`POST /api/mailboxes` · Praecise account · Mailboxes

The mailbox reads with the Praecise account; it has no password of its own.

## Request body

`application/json`

```json
{
  "type": "object",
  "required": [
    "localpart",
    "domain"
  ],
  "properties": {
    "localpart": {
      "type": "string",
      "description": "The part before the @.",
      "examples": [
        "hello"
      ]
    },
    "domain": {
      "type": "string",
      "examples": [
        "example.com"
      ]
    },
    "name": {
      "type": "string",
      "description": "Shown as the sender. The local part when left out."
    },
    "kind": {
      "type": "string",
      "enum": [
        "human",
        "agent",
        "machine"
      ],
      "default": "human",
      "description": "What holds the address: a person, an agent, or a machine.",
      "title": "Kind"
    }
  }
}
```

## Responses

- `201`: Made.
- `400`: The local part is not usable, or `kind` is not one of the three.
- `401`: Neither a service token nor a signed-in session was accepted.
- `404`: That domain is not on this account.
- `409`: That domain is not verified yet.
- `502`: The mail service could not be reached, or refused.
- `503`: Mail is not configured on this deployment.

## Example

```sh
curl -X POST 'https://accounts.praecise.com/api/mailboxes' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "localpart": "hello",
  "domain": "example.com"
}'
```