The shop's own pages and what new pages can start from
- Credentials
- OAuth access token
- Scopes
store:read
Every shop also has a built-in Contact page at /contact.
Access: OAuth scope store:read; not write-gated.
Paged: { items, nextCursor }, limit (default 50, at most 200) and an opaque cursor.
merchantOAuth store:readAuthorizationBearer <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: store:read
storeId*stringA store the person can reach. Any other id answers 404, never 403.
cursor?stringThe nextCursor of the previous page, unchanged. A cursor that is not one we gave you is 400 bad_request.
limit?integerPage size: default 50, at most 200 (more is 200; a missing or unusable value is 50).
1 <= value <= 20050OK
application/json- response
data*curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/pages' \ -H 'Authorization: Bearer <access_token>'{ "data": { "items": [], "nextCursor": null, "startFrom": [ "contact", "about", "faq" ], "plan": { "anyPage": true, "maxPages": 50 } }}Write a new page with AI, as a draft POST
A recipe or a line about what the page is for (and up to 6 listings it is about); one model call writes the words and the blocks come from the shop's own data. The page is a DRAFT, never published. Growth and Scale (403 `plan_limit`). Credits are checked first and charged only once the page exists (403 `insufficient_credits`). Access: OAuth scope `ai:spend`; owner/admin only; write-gated by the subscription.
Make a page, or save a new draft of one POST
New: `startFrom` "about", "contact", "faq", "team" and more (see `listPages`), or "blank" with your own `blocks`. Edit: `pageId` plus `title` and/or `blocks` (blocks replace the page's blocks). Saves a draft; shoppers see it after `publishPage`. Access: OAuth scope `design:write`; owner/admin only; write-gated by the subscription.