Developers
Menus

Create a menu item

POST/menus/{menu_key}/items

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.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

menu_key*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/menus/string/items" \  -H "Content-Type: application/json" \  -d '{    "destination": {},    "kind": "shortcut",    "label": "string"  }'
{  "data": {    "destination": {      "embed": "string",      "product_id": "string",      "shortcut": "string",      "showcase_id": "string",      "url": "string"    },    "id": "string",    "kind": "shortcut",    "label": "string",    "object": "menu_item",    "position": 0,    "revision": "string",    "target": "_self",    "visible": true  }}

List menu items GET

Returns every item in the menu, in display order, in a single response while preserving the standard collection response format.

Reorder menu items PUT

Sets the display order of the menu items. The `ids` array must contain the public ID of every item in the menu, in the desired order. Partial reordering is not supported. If the supplied set does not match, the API returns the `order_set_mismatch` error code and the existing order remains unchanged.