# willo_shopify_sales

> Sales from the business's Shopify store for a period, read live through the Willo Shopify app: orders, revenue as ordered and after refunds…

Generated from Willo's code at each release.

Source: https://www.willo.ai/docs/reference/mcp-tools/willo-shopify-sales

**Shopify sales.** Sales from the business's Shopify store for a period, read live through the Willo Shopify app: orders, revenue as ordered and after refunds, average order value, then the best-selling products by revenue. Amounts are in the shop's currency, include tax and shipping, and leave out cancelled and test orders. A result marked PARTIAL covers only part of the period (busy periods are capped, and Shopify shares only the last 60 days of orders): say so, or ask for a shorter period. A store connected with a Storefront token instead of the app has no order access, and the result says to upgrade the connection. Needs owner or admin rank on the business: below that the call is refused and nothing is read. Orders are changed in Shopify admin, never here. Free, read-only.

## Access

- **Token**: read or read + act.
- **Approval**: Never. This tool only reads.
- **Owner or admin only**: the person who created the token must still be an owner or admin of the business.
- **Metered**: counts toward a per-business, per-minute limit for this kind of call. See [Limits](https://www.willo.ai/docs/reference/limits).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `period` | string (today or yesterday or last_7_days or last_30_days or last_90_days or this_month or last_month or custom) | yes | Which days, in the shop's timezone. last_N_days include today. |
| `start_date` | string | no | period=custom: first day, YYYY-MM-DD. |
| `end_date` | string | no | period=custom: last day (inclusive), YYYY-MM-DD; at most 366 days. |
| `limit` | integer 1–20 | no | How many top products to list (default 10). |

## Related

- [All MCP tools](https://www.willo.ai/docs/reference/mcp-tools)
- [Error codes](https://www.willo.ai/docs/reference/errors)
- [Draft and live](https://www.willo.ai/docs/ai-agents/draft-and-live)