---
title: "Create a navigation menu"
method: POST
path: "/v1/commerce/menus"
tags: ["Commerce"]
---

# Create a navigation menu

`POST /v1/commerce/menus`

Creates a navigation menu from `title`, `handle` and up to 100 `items`, and returns it with status 201. Shopify only. Needs navigation.write.

## Request body

- object
  - `accountId` string, required
  - `title` string, required
  - `handle` string, required
  - `items` CommerceMenuItemInput[], required
    - `title` string, required
    - `type` 'frontpage' | 'collection' | 'collections' | 'product' | 'catalog' | 'page' | 'blog' | 'article' | 'search' | 'shop_policy' | 'http' | 'metaobject' | 'customer_account_page', required
    - `url` string — For http items.
    - `resourceId` string — For product, collection, page, blog, article and metaobject items.
    - `items` CommerceMenuItemInput[]

## Response `201`

Menu created

- object
  - `menu` CommerceMenu
    - `id` string
    - `handle` string
    - `title` string
    - `items` CommerceMenuItem[]
      - `id` string, nullable
      - `title` string
      - `type` 'frontpage' | 'collection' | 'collections' | 'product' | 'catalog' | 'page' | 'blog' | 'article' | 'search' | 'shop_policy' | 'http' | 'metaobject' | 'customer_account_page'
      - `url` string, nullable
      - `resourceId` string, nullable — The linked product, collection, page, blog, article or metaobject id.
      - `items` CommerceMenuItem[]

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — The store has not granted this permission, or the token was revoked (code insufficient_permissions). Reconnect the store to grant the latest permissions; GET /v1/commerce/store lists what the current grant allows.
- `404` — Account not found (code account_not_found) or the resource was not found (code product_not_found or resource_not_found).
- `429` — Rate limited, either by Zernio or by the platform. Retry later.

## Changes

- **2026-09-30** `16a7b9d5373e` — 1 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `400`
- **2026-09-29** `69bbe3da3a18` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/commerce/menus/post.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/16a7b9d5373e?raw)