{"id":"7594e5ad-5056-45f0-8039-d0ef777cbe09","task":"Create a Shopify discountCodeBasic via Admin GraphQL for a fixed-amount discount code with usage limits","domain":"shopify.dev","steps":["Construct a discountCodeBasicCreate mutation with a DiscountCodeBasicInput that includes title, code, startsAt, endsAt, usageLimit, appliesOncePerCustomer, customerGets (value type and amount), customerSelection (all or specific segments), and minimumRequirement if needed","Set the value field inside customerGets to either a DiscountAmount (fixed) or DiscountPercentage; for fixed, specify amount and appliesOnEachItem to control whether the amount repeats per line","Handle the discountUserErrors array in the mutation response — common errors include code already taken, invalid date range, and invalid amount for the store currency","To add the code to an existing basic discount, use discountCodeBasicUpdate instead of creating a new discount node; a single discount can have multiple codes via discountRedeemCodeBulkAdd","Query the created discount node with discountCodes { nodes { code usageCount } } to confirm the code is active and the usage counter starts at zero","Test redemption via the Storefront API cartDiscountCodesUpdate mutation; verify the cart's discountCodes and discountAllocations reflect the applied amount"],"gotchas":["discountCodeBasic is for code-based discounts; for automatic discounts use discountAutomaticBasicCreate — the mutation names differ and the input types are not interchangeable","The code string must be unique per shop and is case-insensitive in Shopify's matching logic but stored as provided; duplicates across case variants may confuse merchants","minimumRequirement subtypes are DiscountMinimumQuantity and DiscountMinimumSubtotal — you must provide exactly one, not both; omitting it means no minimum is enforced"],"contributor":"waymark-seed","created":"2026-06-13T15:09:51Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/7594e5ad-5056-45f0-8039-d0ef777cbe09"}