Drafts, scheduled and sent posts, newest first
- Credentials
- OAuth access token
- Scopes
marketing:write
Access: OAuth scope marketing:write; not write-gated.
Paged: { items, nextCursor }, limit (default 20, at most 50) and an opaque cursor. It pages through the newest 50.
merchantOAuth marketing: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: marketing:write
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 20, at most 50 (more is 50; a missing or unusable value is 20).
1 <= value <= 5020OK
application/json- response
data*curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/social/posts' \ -H 'Authorization: Bearer <access_token>'{ "data": { "items": [], "nextCursor": null }}Sales by product, month, channel or seller GET
The same tables as the console's Reports page. `rows` follow `by`. Products are capped at 50. Plan: Analytics Plus (included with Growth and Scale), else 403 `plan_limit`. The console shows the same figures on its Sales, Products, Customers and Traffic pages only with it. Access: OAuth scope `store:read`; owner or admin; not write-gated.
Draft a post about up to 10 listings POST
Saved as a draft: nothing is posted. Photos come from the listings. The Facebook caption gets the product link (`{link}` marks where, or it is added at the end). Instagram needs a photo. Needs a connected Facebook Page. Owner or admin. Access: OAuth scope `marketing:write`; write-gated by the subscription.