The shop's top menu as it is
- Credentials
- OAuth access token
- Scopes
design:write- Role
- Owners and admins only. Staff get
403 forbidden.
mode: auto is the menu every shop starts with.
It shows the menu when sent nothing.
Access: OAuth scope design:write; owner/admin only; not write-gated.
merchantOAuth design:writeAuthorizationBearer <token>OAuth 2.1 (authorization code + PKCE S256, public clients, dynamic registration) for connected AI apps. Effective power is scopes granted AND the person's role today AND the plan. orders:refund, billing:write and team:write are opt-in on the consent screen. Write implies read for marketing:read and messages:read, so a grant holding marketing:write passes a marketing:read check, and messages:send passes messages:read.
Scope: design:write
storeId*stringA store the person can reach. Any other id answers 404, never 403.
OK
application/json- response
data*curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/menu' \ -H 'Authorization: Bearer <access_token>'{ "data": { "menu": { "mode": "auto", "style": null, "items": [], "says": "Automatic: one link per kind you sell, pages ticked for the menu, then Contact." }, "liveUrl": "https://jabus-plant-shop.shopeazy.co" }}Change the brand: logo, colours, tagline and voice PATCH
Only what is sent changes. Live at once on receipts and emails; the shop design's own colours are set with `setStoreLook`. Access: OAuth scope `design:write`; owner/admin only; write-gated by the subscription.
Change the shop's top menu PUT
`auto` is the menu every shop starts with; `custom` is the merchant's own list, up to 7 links. Dropdowns and the mega style come with Growth (403 `plan_limit`). Live at once. Access: OAuth scope `design:write`; owner/admin only; write-gated by the subscription.