# Create a menu item

`POST https://api.cademi.com.br/api/v3/menus/{menu_key}/items`

Operation ID: `menu_items.create` · API v3

Creates a menu item. New items are added to the end of the menu.

URL and embed destinations must use the HTTP or HTTPS scheme. Product and showcase destinations must reference a product or showcase that exists in the current account.

Required permissions: `menu_items.create`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `menu_key` | path | string | yes |  |

## Request body

Content type: `application/json`, required.

| Field | Type | Required | Description |
|---|---|---|---|
| `destination` | object | yes |  |
| `kind` | string, one of `shortcut`, `product`, `showcase`, `url`, `embed` | yes |  |
| `label` | string | yes |  |
| `target` | string, one of `_self`, `_blank` | no |  |

## Responses

### 201

Returns the newly created menu item.

Body: `data`: MenuItem.

Fields of MenuItem:

| Field | Type | Required | Description |
|---|---|---|---|
| `destination` | object | yes |  |
| `id` | string | yes | Public ID, with the mnu_ prefix. |
| `kind` | string, one of `shortcut`, `product`, `showcase`, `url`, `embed` | yes |  |
| `label` | string | yes |  |
| `object` | string, one of `menu_item` | yes |  |
| `position` | integer | yes |  |
| `revision` | string | yes |  |
| `target` | string, one of `_self`, `_blank` | yes |  |
| `visible` | boolean | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The menu key is not recognized.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json