**CLI:**

```
agentmail inboxes create --display-name "My Agent" --username myagent --domain agentmail.to
```

### Authentication

AuthorizationBearer

Bearer authentication of the form `Bearer <token>`, where token is your auth token.

### Request

This endpoint expects an optional object.

- **username** `string` Optional
  
  Username of address. Randomly generated if not specified.

- **domain** `string` Optional
  
  Domain of address. Must be verified domain. Defaults to `agentmail.to`.

- **display_name** `string` Optional
  
  Display name: `Display Name <username@domain.com>`.

- **client_id** `string` Optional
  
  Client ID of inbox.

### Response

This endpoint returns an object.

- **pod_id** `string`
  
  ID of pod.

- **inbox_id** `string`
  
  The ID of the inbox.

- **email** `string`
  
  Email address of the inbox.

- **updated_at** `datetime`
  
  Time at which inbox was last updated.

- **created_at** `datetime`
  
  Time at which inbox was created.

- **display_name** `string`
  
  Display name: `Display Name <username@domain.com>`.

- **client_id** `string`
  
  Client ID of inbox.

### Errors

- **400**
  
  Validation Error