Create a Shopify automatic app discount backed by a deployed Shopify Function using the discountAutomaticAppCreate Admin GraphQL mutation

In-depth guide

Steps

1. Deploy your Shopify Function (e.g., a cart-line discount using the `cart.lines.discounts.generate.run` target) and note the Function ID from the Partner Dashboard or the CLI deploy output
2. Call `discountAutomaticAppCreate(automaticAppDiscount: { title: "Volume Discount", functionId: $functionId, startsAt: "2025-01-01T00:00:00Z", combinesWith: { orderDiscounts: false, productDiscounts: true, shippingDiscounts: true } })` with `write_discounts` access scope
3. The mutation returns a `DiscountAutomaticApp` object with the discount `id` and `status` — verify `status` is `ACTIVE` before testing
4. Store any Function configuration data (thresholds, percentages) in a metafield on the discount using `metafieldsSet` targeting the `DiscountAutomaticApp` GID; the Function reads this via its `metafield` input in the run query
5. Test by placing an order that meets the discount criteria and confirming the Function-applied discount appears on the order's `discountApplications`
6. Monitor Function execution errors via the Partner Dashboard's Function logs or the CLI `shopify app dev --log-level debug` output