# Expose a port

`POST /v1/sandboxes/{sandbox}/endpoints`

**In this build:** Works on the simulator or a real VM.

**Scope:** `host`

**CLI:** `harebox host`

## Request: `CreateEndpointRequest`

| Field | Type | Notes |
|---|---|---|
| `port` (required) | `integer` |  |
| `protocol` | `string` | One of: `https`, `tcp`, `udp` |
| `auth` | `string` | One of: `public`, `token`, `oidc`, `mtls` |
| `title` | `string` |  |
| `domain` | `string` |  |
| `wake_on_request` | `boolean` |  |
| `allowed_emails` | `array` |  |

## Response: 201

`Endpoint`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `port` (required) | `integer` |  |
| `protocol` (required) | `string` |  |
| `auth` (required) | `string` |  |
| `url` (required) | `string` |  |
| `token` | `string or null` | Returned on create and on rotate only. |
| `domain` | `string or null` |  |

Errors follow [one format](../errors.html).