shopify_create_menu
DestructiveIdempotent
Create storefront navigation menus with up to three nested levels, linking to collections, products, pages, or catalogs. Verifies the complete menu tree before confirming creation.
Instructions
Create a storefront navigation menu (e.g. a 'main-menu' replacement or a footer menu) with at most three item levels. The connector independently reads back and compares the complete tree before success. Requires the online-store-navigation scopes; a connection without them returns SHOPIFY_NAVIGATION_SCOPE_REQUIRED (offer a Shopify reconnect).
Args:
title (required): Menu title shown in the admin (e.g. 'Main menu').
handle (required): Menu handle referenced by the theme (e.g. 'main-menu', 'footer').
items (required): JSON-string list of menu items: [{title, type?, url?, resource_id?, items?}]. type defaults to HTTP (a plain link); use COLLECTION/PRODUCT/PAGE/CATALOG with resource_id (a GID) to link store resources. Nested items may be at most three levels deep.
project_id: Authenticated Project UUID.
project_ref: Exact project correlation reference.
connector_account_ref: Project-bound connector account alias.
idempotency_key: Stable business-action identity.
effect: Claimed read or write effect; Spring verifies it.
approval_ref: Approved platform task UUID when resuming a write.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | ||
| title | No | ||
| effect | No | ||
| handle | No | ||
| project_id | No | ||
| project_ref | No | ||
| approval_ref | No | ||
| idempotency_key | No | ||
| connector_account_ref | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |