Choose a version:

discountAutomaticBasicCreate

mutation

Requires Apps must have write_discounts access scope.

Creates an amount off discount that's automatically applied on a cart and at checkout.

Note

To create code discounts, use the discountCodeBasicCreate mutation.

Anchor to Arguments

Arguments

Anchor to automaticBasicDiscountautomaticBasicDiscount

•DiscountAutomaticBasicInput!

required

The input data used to create the automatic amount off discount.

Show input fields

Was this section helpful?

Anchor to DiscountAutomaticBasicCreatePayload returnsDiscountAutomaticBasicCreatePayload returns

Anchor to automaticDiscountNodeautomaticDiscountNode •DiscountAutomaticNode: The automatic discount that was created.

Show fields
Anchor to userErrorsuserErrors •[DiscountUserError!]! non-null: The list of errors that occurred from executing the mutation.

Show fields

Was this section helpful?

Examples

Create a combinable automatic discount

Description

Create an [automatic discount](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts) that offers $10.00 off on orders over $100.00 and can also be [combined](https://help.shopify.com/manual/discounts/combining-discounts/discount-combinations) with shipping discounts.

Query

mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          title
          startsAt
          combinesWith {
            productDiscounts
            shippingDiscounts
            orderDiscounts
          }
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}

Variables

{
  "automaticBasicDiscount": {
    "title": "$10 off orders over $100 (combinable with shipping discounts)",
    "startsAt": "2025-07-24T16:19:41-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "100.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "10.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    },
    "combinesWith": {
      "productDiscounts": false,
      "shippingDiscounts": true,
      "orderDiscounts": false
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { title startsAt combinesWith { productDiscounts shippingDiscounts orderDiscounts } minimumRequirement { ... on DiscountMinimumSubtotal { greaterThanOrEqualToSubtotal { amount currencyCode } } } customerGets { value { ... on DiscountAmount { amount { amount currencyCode } } } items { ... on AllDiscountItems { allItems } } } } } } userErrors { field code message } } }",
 "variables": {
    "automaticBasicDiscount": {
      "title": "$10 off orders over $100 (combinable with shipping discounts)",
      "startsAt": "2025-07-24T16:19:41-04:00",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "100.00"
        }
      },
      "customerGets": {
        "value": {
          "discountAmount": {
            "amount": "10.00",
            "appliesOnEachItem": false
          }
        },
        "items": {
          "all": true
        }
      },
      "combinesWith": {
        "productDiscounts": false,
        "shippingDiscounts": true,
        "orderDiscounts": false
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            title
            startsAt
            combinesWith {
              productDiscounts
              shippingDiscounts
              orderDiscounts
            }
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }`,
  {
    variables: {
        "automaticBasicDiscount": {
            "title": "$10 off orders over $100 (combinable with shipping discounts)",
            "startsAt": "2025-07-24T16:19:41-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "100.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "10.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            },
            "combinesWith": {
                "productDiscounts": false,
                "shippingDiscounts": true,
                "orderDiscounts": false
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            title
            startsAt
            combinesWith {
              productDiscounts
              shippingDiscounts
              orderDiscounts
            }
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }
QUERY

variables = {
  "automaticBasicDiscount": {
    "title": "$10 off orders over $100 (combinable with shipping discounts)",
    "startsAt": "2025-07-24T16:19:41-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "100.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "10.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    },
    "combinesWith": {
      "productDiscounts": false,
      "shippingDiscounts": true,
      "orderDiscounts": false
    }
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
      discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
        automaticDiscountNode {
          id
          automaticDiscount {
            ... on DiscountAutomaticBasic {
              title
              startsAt
              combinesWith {
                productDiscounts
                shippingDiscounts
                orderDiscounts
              }
              minimumRequirement {
                ... on DiscountMinimumSubtotal {
                  greaterThanOrEqualToSubtotal {
                    amount
                    currencyCode
                  }
                }
              }
              customerGets {
                value {
                  ... on DiscountAmount {
                    amount {
                      amount
                      currencyCode
                    }
                  }
                }
                items {
                  ... on AllDiscountItems {
                    allItems
                  }
                }
              }
            }
          }
        }
        userErrors {
          field
          code
          message
        }
      }
    }`,
    "variables": {
        "automaticBasicDiscount": {
            "title": "$10 off orders over $100 (combinable with shipping discounts)",
            "startsAt": "2025-07-24T16:19:41-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "100.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "10.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            },
            "combinesWith": {
                "productDiscounts": false,
                "shippingDiscounts": true,
                "orderDiscounts": false
            }
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          title
          startsAt
          combinesWith {
            productDiscounts
            shippingDiscounts
            orderDiscounts
          }
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}' \
--variables \
'{
  "automaticBasicDiscount": {
    "title": "$10 off orders over $100 (combinable with shipping discounts)",
    "startsAt": "2025-07-24T16:19:41-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "100.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "10.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    },
    "combinesWith": {
      "productDiscounts": false,
      "shippingDiscounts": true,
      "orderDiscounts": false
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
        discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
          automaticDiscountNode {
            id
            automaticDiscount {
              ... on DiscountAutomaticBasic {
                title
                startsAt
                combinesWith {
                  productDiscounts
                  shippingDiscounts
                  orderDiscounts
                }
                minimumRequirement {
                  ... on DiscountMinimumSubtotal {
                    greaterThanOrEqualToSubtotal {
                      amount
                      currencyCode
                    }
                  }
                }
                customerGets {
                  value {
                    ... on DiscountAmount {
                      amount {
                        amount
                        currencyCode
                      }
                    }
                  }
                  items {
                    ... on AllDiscountItems {
                      allItems
                    }
                  }
                }
              }
            }
          }
          userErrors {
            field
            code
            message
          }
        }
      }
    `,
    variables: {
        "automaticBasicDiscount": {
            "title": "$10 off orders over $100 (combinable with shipping discounts)",
            "startsAt": "2025-07-24T16:19:41-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "100.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "10.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            },
            "combinesWith": {
                "productDiscounts": false,
                "shippingDiscounts": true,
                "orderDiscounts": false
            }
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountAutomaticBasicCreate": {
    "automaticDiscountNode": {
      "id": "gid://shopify/DiscountAutomaticNode/1057856663",
      "automaticDiscount": {
        "title": "$10 off orders over $100 (combinable with shipping discounts)",
        "startsAt": "2025-07-24T20:19:41Z",
        "combinesWith": {
          "productDiscounts": false,
          "shippingDiscounts": true,
          "orderDiscounts": false
        },
        "minimumRequirement": {
          "greaterThanOrEqualToSubtotal": {
            "amount": "100.0",
            "currencyCode": "USD"
          }
        },
        "customerGets": {
          "value": {
            "amount": {
              "amount": "10.0",
              "currencyCode": "USD"
            }
          },
          "items": {
            "allItems": true
          }
        }
      }
    },
    "userErrors": []
  }
}

Create a fixed amount off discount

Description

Create an [automatic discount](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts) that offers $50.00 off on all orders over $200.00. The discount applies to all customers on all items from June through September 2025.

Query

mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          startsAt
          endsAt
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
                appliesOnEachItem
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}

Variables

{
  "automaticBasicDiscount": {
    "title": "$50 off all orders over $200 (June - September 2025)",
    "startsAt": "2025-06-01T00:00:00Z",
    "endsAt": "2025-09-30T00:00:00Z",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "200.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "50.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { startsAt endsAt minimumRequirement { ... on DiscountMinimumSubtotal { greaterThanOrEqualToSubtotal { amount currencyCode } } } customerGets { value { ... on DiscountAmount { amount { amount currencyCode } appliesOnEachItem } } items { ... on AllDiscountItems { allItems } } } } } } userErrors { field code message } } }",
 "variables": {
    "automaticBasicDiscount": {
      "title": "$50 off all orders over $200 (June - September 2025)",
      "startsAt": "2025-06-01T00:00:00Z",
      "endsAt": "2025-09-30T00:00:00Z",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "200.00"
        }
      },
      "customerGets": {
        "value": {
          "discountAmount": {
            "amount": "50.00",
            "appliesOnEachItem": false
          }
        },
        "items": {
          "all": true
        }
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            startsAt
            endsAt
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                  appliesOnEachItem
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }`,
  {
    variables: {
        "automaticBasicDiscount": {
            "title": "$50 off all orders over $200 (June - September 2025)",
            "startsAt": "2025-06-01T00:00:00Z",
            "endsAt": "2025-09-30T00:00:00Z",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "200.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "50.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            startsAt
            endsAt
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                  appliesOnEachItem
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }
QUERY

variables = {
  "automaticBasicDiscount": {
    "title": "$50 off all orders over $200 (June - September 2025)",
    "startsAt": "2025-06-01T00:00:00Z",
    "endsAt": "2025-09-30T00:00:00Z",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "200.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "50.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    }
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
      discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
        automaticDiscountNode {
          id
          automaticDiscount {
            ... on DiscountAutomaticBasic {
              startsAt
              endsAt
              minimumRequirement {
                ... on DiscountMinimumSubtotal {
                  greaterThanOrEqualToSubtotal {
                    amount
                    currencyCode
                  }
                }
              }
              customerGets {
                value {
                  ... on DiscountAmount {
                    amount {
                      amount
                      currencyCode
                    }
                    appliesOnEachItem
                  }
                }
                items {
                  ... on AllDiscountItems {
                    allItems
                  }
                }
              }
            }
          }
        }
        userErrors {
          field
          code
          message
        }
      }
    }`,
    "variables": {
        "automaticBasicDiscount": {
            "title": "$50 off all orders over $200 (June - September 2025)",
            "startsAt": "2025-06-01T00:00:00Z",
            "endsAt": "2025-09-30T00:00:00Z",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "200.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "50.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          startsAt
          endsAt
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
                appliesOnEachItem
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}' \
--variables \
'{
  "automaticBasicDiscount": {
    "title": "$50 off all orders over $200 (June - September 2025)",
    "startsAt": "2025-06-01T00:00:00Z",
    "endsAt": "2025-09-30T00:00:00Z",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "200.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "50.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
        discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
          automaticDiscountNode {
            id
            automaticDiscount {
              ... on DiscountAutomaticBasic {
                startsAt
                endsAt
                minimumRequirement {
                  ... on DiscountMinimumSubtotal {
                    greaterThanOrEqualToSubtotal {
                      amount
                      currencyCode
                    }
                  }
                }
                customerGets {
                  value {
                    ... on DiscountAmount {
                      amount {
                        amount
                        currencyCode
                      }
                      appliesOnEachItem
                    }
                  }
                  items {
                    ... on AllDiscountItems {
                      allItems
                    }
                  }
                }
              }
            }
          }
          userErrors {
            field
            code
            message
          }
        }
      }
    `,
    variables: {
        "automaticBasicDiscount": {
            "title": "$50 off all orders over $200 (June - September 2025)",
            "startsAt": "2025-06-01T00:00:00Z",
            "endsAt": "2025-09-30T00:00:00Z",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "200.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "50.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountAutomaticBasicCreate": {
    "automaticDiscountNode": {
      "id": "gid://shopify/DiscountAutomaticNode/1057856662",
      "automaticDiscount": {
        "startsAt": "2025-06-01T00:00:00Z",
        "endsAt": "2025-09-30T00:00:00Z",
        "minimumRequirement": {
          "greaterThanOrEqualToSubtotal": {
            "amount": "200.0",
            "currencyCode": "USD"
          }
        },
        "customerGets": {
          "value": {
            "amount": {
              "amount": "50.0",
              "currencyCode": "USD"
            },
            "appliesOnEachItem": false
          },
          "items": {
            "allItems": true
          }
        }
      }
    },
    "userErrors": []
  }
}

Create a fixed amount off discount for a customer segment

Description

Create an [automatic discount](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts) that offers $50.00 off on all orders over $200.00. The discount applies to customers from a specific customer segment on all items.

Query

mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          startsAt
          endsAt
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          context {
            ... on DiscountCustomerSegments {
              segments {
                id
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
                appliesOnEachItem
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}

Variables

{
  "automaticBasicDiscount": {
    "title": "$50 off all orders over $200",
    "startsAt": "2026-04-29T02:44:55-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "200.00"
      }
    },
    "context": {
      "customerSegments": {
        "add": [
          "gid://shopify/Segment/210588551"
        ]
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "50.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { startsAt endsAt minimumRequirement { ... on DiscountMinimumSubtotal { greaterThanOrEqualToSubtotal { amount currencyCode } } } context { ... on DiscountCustomerSegments { segments { id } } } customerGets { value { ... on DiscountAmount { amount { amount currencyCode } appliesOnEachItem } } items { ... on AllDiscountItems { allItems } } } } } } userErrors { field code message } } }",
 "variables": {
    "automaticBasicDiscount": {
      "title": "$50 off all orders over $200",
      "startsAt": "2026-04-29T02:44:55-04:00",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "200.00"
        }
      },
      "context": {
        "customerSegments": {
          "add": [
            "gid://shopify/Segment/210588551"
          ]
        }
      },
      "customerGets": {
        "value": {
          "discountAmount": {
            "amount": "50.00",
            "appliesOnEachItem": false
          }
        },
        "items": {
          "all": true
        }
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            startsAt
            endsAt
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            context {
              ... on DiscountCustomerSegments {
                segments {
                  id
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                  appliesOnEachItem
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }`,
  {
    variables: {
        "automaticBasicDiscount": {
            "title": "$50 off all orders over $200",
            "startsAt": "2026-04-29T02:44:55-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "200.00"
                }
            },
            "context": {
                "customerSegments": {
                    "add": [
                        "gid://shopify/Segment/210588551"
                    ]
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "50.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            startsAt
            endsAt
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            context {
              ... on DiscountCustomerSegments {
                segments {
                  id
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                  appliesOnEachItem
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }
QUERY

variables = {
  "automaticBasicDiscount": {
    "title": "$50 off all orders over $200",
    "startsAt": "2026-04-29T02:44:55-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "200.00"
      }
    },
    "context": {
      "customerSegments": {
        "add": [
          "gid://shopify/Segment/210588551"
        ]
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "50.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    }
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
      discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
        automaticDiscountNode {
          id
          automaticDiscount {
            ... on DiscountAutomaticBasic {
              startsAt
              endsAt
              minimumRequirement {
                ... on DiscountMinimumSubtotal {
                  greaterThanOrEqualToSubtotal {
                    amount
                    currencyCode
                  }
                }
              }
              context {
                ... on DiscountCustomerSegments {
                  segments {
                    id
                  }
                }
              }
              customerGets {
                value {
                  ... on DiscountAmount {
                    amount {
                      amount
                      currencyCode
                    }
                    appliesOnEachItem
                  }
                }
                items {
                  ... on AllDiscountItems {
                    allItems
                  }
                }
              }
            }
          }
        }
        userErrors {
          field
          code
          message
        }
      }
    }`,
    "variables": {
        "automaticBasicDiscount": {
            "title": "$50 off all orders over $200",
            "startsAt": "2026-04-29T02:44:55-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "200.00"
                }
            },
            "context": {
                "customerSegments": {
                    "add": [
                        "gid://shopify/Segment/210588551"
                    ]
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "50.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          startsAt
          endsAt
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          context {
            ... on DiscountCustomerSegments {
              segments {
                id
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
                appliesOnEachItem
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}' \
--variables \
'{
  "automaticBasicDiscount": {
    "title": "$50 off all orders over $200",
    "startsAt": "2026-04-29T02:44:55-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "200.00"
      }
    },
    "context": {
      "customerSegments": {
        "add": [
          "gid://shopify/Segment/210588551"
        ]
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "50.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
        discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
          automaticDiscountNode {
            id
            automaticDiscount {
              ... on DiscountAutomaticBasic {
                startsAt
                endsAt
                minimumRequirement {
                  ... on DiscountMinimumSubtotal {
                    greaterThanOrEqualToSubtotal {
                      amount
                      currencyCode
                    }
                  }
                }
                context {
                  ... on DiscountCustomerSegments {
                    segments {
                      id
                    }
                  }
                }
                customerGets {
                  value {
                    ... on DiscountAmount {
                      amount {
                        amount
                        currencyCode
                      }
                      appliesOnEachItem
                    }
                  }
                  items {
                    ... on AllDiscountItems {
                      allItems
                    }
                  }
                }
              }
            }
          }
          userErrors {
            field
            code
            message
          }
        }
      }
    `,
    variables: {
        "automaticBasicDiscount": {
            "title": "$50 off all orders over $200",
            "startsAt": "2026-04-29T02:44:55-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "200.00"
                }
            },
            "context": {
                "customerSegments": {
                    "add": [
                        "gid://shopify/Segment/210588551"
                    ]
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "50.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountAutomaticBasicCreate": {
    "automaticDiscountNode": {
      "id": "gid://shopify/DiscountAutomaticNode/1057856792",
      "automaticDiscount": {
        "startsAt": "2026-04-29T06:44:55Z",
        "endsAt": null,
        "minimumRequirement": {
          "greaterThanOrEqualToSubtotal": {
            "amount": "200.0",
            "currencyCode": "USD"
          }
        },
        "context": {
          "segments": [
            {
              "id": "gid://shopify/Segment/210588551"
            }
          ]
        },
        "customerGets": {
          "value": {
            "amount": {
              "amount": "50.0",
              "currencyCode": "USD"
            },
            "appliesOnEachItem": false
          },
          "items": {
            "allItems": true
          }
        }
      }
    },
    "userErrors": []
  }
}

Create a percentage off discount with a minimum purchase

Description

Create an [automatic discount](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts) that offers 15% off when customers spend $50.00 or more. The discount applies to all items.

Query

mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          title
          startsAt
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountPercentage {
                percentage
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}

Variables

{
  "automaticBasicDiscount": {
    "title": "15% off orders over $50",
    "startsAt": "2024-01-01T00:00:00Z",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "50.00"
      }
    },
    "customerGets": {
      "value": {
        "percentage": 0.15
      },
      "items": {
        "all": true
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { title startsAt minimumRequirement { ... on DiscountMinimumSubtotal { greaterThanOrEqualToSubtotal { amount currencyCode } } } customerGets { value { ... on DiscountPercentage { percentage } } items { ... on AllDiscountItems { allItems } } } } } } userErrors { field code message } } }",
 "variables": {
    "automaticBasicDiscount": {
      "title": "15% off orders over $50",
      "startsAt": "2024-01-01T00:00:00Z",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "50.00"
        }
      },
      "customerGets": {
        "value": {
          "percentage": 0.15
        },
        "items": {
          "all": true
        }
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            title
            startsAt
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountPercentage {
                  percentage
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }`,
  {
    variables: {
        "automaticBasicDiscount": {
            "title": "15% off orders over $50",
            "startsAt": "2024-01-01T00:00:00Z",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "50.00"
                }
            },
            "customerGets": {
                "value": {
                    "percentage": 0.15
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            title
            startsAt
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountPercentage {
                  percentage
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }
QUERY

variables = {
  "automaticBasicDiscount": {
    "title": "15% off orders over $50",
    "startsAt": "2024-01-01T00:00:00Z",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "50.00"
      }
    },
    "customerGets": {
      "value": {
        "percentage": 0.15
      },
      "items": {
        "all": true
      }
    }
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
      discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
        automaticDiscountNode {
          id
          automaticDiscount {
            ... on DiscountAutomaticBasic {
              title
              startsAt
              minimumRequirement {
                ... on DiscountMinimumSubtotal {
                  greaterThanOrEqualToSubtotal {
                    amount
                    currencyCode
                  }
                }
              }
              customerGets {
                value {
                  ... on DiscountPercentage {
                    percentage
                  }
                }
                items {
                  ... on AllDiscountItems {
                    allItems
                  }
                }
              }
            }
          }
        }
        userErrors {
          field
          code
          message
        }
      }
    }`,
    "variables": {
        "automaticBasicDiscount": {
            "title": "15% off orders over $50",
            "startsAt": "2024-01-01T00:00:00Z",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "50.00"
                }
            },
            "customerGets": {
                "value": {
                    "percentage": 0.15
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          title
          startsAt
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountPercentage {
                percentage
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}' \
--variables \
'{
  "automaticBasicDiscount": {
    "title": "15% off orders over $50",
    "startsAt": "2024-01-01T00:00:00Z",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "50.00"
      }
    },
    "customerGets": {
      "value": {
        "percentage": 0.15
      },
      "items": {
        "all": true
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
        discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
          automaticDiscountNode {
            id
            automaticDiscount {
              ... on DiscountAutomaticBasic {
                title
                startsAt
                minimumRequirement {
                  ... on DiscountMinimumSubtotal {
                    greaterThanOrEqualToSubtotal {
                      amount
                      currencyCode
                    }
                  }
                }
                customerGets {
                  value {
                    ... on DiscountPercentage {
                      percentage
                    }
                  }
                  items {
                    ... on AllDiscountItems {
                      allItems
                    }
                  }
                }
              }
            }
          }
          userErrors {
            field
            code
            message
          }
        }
      }
    `,
    variables: {
        "automaticBasicDiscount": {
            "title": "15% off orders over $50",
            "startsAt": "2024-01-01T00:00:00Z",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "50.00"
                }
            },
            "customerGets": {
                "value": {
                    "percentage": 0.15
                },
                "items": {
                    "all": true
                }
            }
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountAutomaticBasicCreate": {
    "automaticDiscountNode": {
      "id": "gid://shopify/DiscountAutomaticNode/1057856665",
      "automaticDiscount": {
        "title": "15% off orders over $50",
        "startsAt": "2024-01-01T00:00:00Z",
        "minimumRequirement": {
          "greaterThanOrEqualToSubtotal": {
            "amount": "50.0",
            "currencyCode": "USD"
          }
        },
        "customerGets": {
          "value": {
            "percentage": 0.15
          },
          "items": {
            "allItems": true
          }
        }
      }
    },
    "userErrors": []
  }
}

discountAutomaticBasicCreate reference

Examples

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {

discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {

automaticDiscountNode {

automaticDiscount {

... on DiscountAutomaticBasic {

title

startsAt

combinesWith {

productDiscounts

shippingDiscounts

orderDiscounts

}

minimumRequirement {

... on DiscountMinimumSubtotal {

greaterThanOrEqualToSubtotal {

amount

currencyCode

}

customerGets {

value {

... on DiscountAmount {

amount {

amount

currencyCode

}

items {

... on AllDiscountItems {

allItems

}

userErrors {

field

code

message

}

}`,

{

variables: {

"automaticBasicDiscount": {

"title": "$10 off orders over $100 (combinable with shipping discounts)",

"startsAt": "2025-07-24T16:19:41-04:00",

"minimumRequirement": {

"subtotal": {

"greaterThanOrEqualToSubtotal": "100.00"

}

"customerGets": {

"value": {

"discountAmount": {

"amount": "10.00",

"appliesOnEachItem": false

}

"items": {

"all": true

}

"combinesWith": {

"productDiscounts": false,

"shippingDiscounts": true,

"orderDiscounts": false

}

);

const json = await response.json();

return json.data;

}

GQL

mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          title
          startsAt
          combinesWith {
            productDiscounts
            shippingDiscounts
            orderDiscounts
          }
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { title startsAt combinesWith { productDiscounts shippingDiscounts orderDiscounts } minimumRequirement { ... on DiscountMinimumSubtotal { greaterThanOrEqualToSubtotal { amount currencyCode } } } customerGets { value { ... on DiscountAmount { amount { amount currencyCode } } } items { ... on AllDiscountItems { allItems } } } } } } userErrors { field code message } } }",
 "variables": {
    "automaticBasicDiscount": {
      "title": "$10 off orders over $100 (combinable with shipping discounts)",
      "startsAt": "2025-07-24T16:19:41-04:00",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "100.00"
        }
      },
      "customerGets": {
        "value": {
          "discountAmount": {
            "amount": "10.00",
            "appliesOnEachItem": false
          }
        },
        "items": {
          "all": true
        }
      },
      "combinesWith": {
        "productDiscounts": false,
        "shippingDiscounts": true,
        "orderDiscounts": false
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            title
            startsAt
            combinesWith {
              productDiscounts
              shippingDiscounts
              orderDiscounts
            }
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }`,
  {
    variables: {
        "automaticBasicDiscount": {
            "title": "$10 off orders over $100 (combinable with shipping discounts)",
            "startsAt": "2025-07-24T16:19:41-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "100.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "10.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            },
            "combinesWith": {
                "productDiscounts": false,
                "shippingDiscounts": true,
                "orderDiscounts": false
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
      discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
        automaticDiscountNode {
          id
          automaticDiscount {
            ... on DiscountAutomaticBasic {
              title
              startsAt
              combinesWith {
                productDiscounts
                shippingDiscounts
                orderDiscounts
              }
              minimumRequirement {
                ... on DiscountMinimumSubtotal {
                  greaterThanOrEqualToSubtotal {
                    amount
                    currencyCode
                  }
                }
              }
              customerGets {
                value {
                  ... on DiscountAmount {
                    amount {
                      amount
                      currencyCode
                    }
                  }
                }
                items {
                  ... on AllDiscountItems {
                    allItems
                  }
                }
              }
            }
          }
        }
        userErrors {
          field
          code
          message
        }
      }
    }`,
    "variables": {
        "automaticBasicDiscount": {
            "title": "$10 off orders over $100 (combinable with shipping discounts)",
            "startsAt": "2025-07-24T16:19:41-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "100.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "10.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            },
            "combinesWith": {
                "productDiscounts": false,
                "shippingDiscounts": true,
                "orderDiscounts": false
            }
        }
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
    discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticBasic {
            title
            startsAt
            combinesWith {
              productDiscounts
              shippingDiscounts
              orderDiscounts
            }
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  amount {
                    amount
                    currencyCode
                  }
                }
              }
              items {
                ... on AllDiscountItems {
                  allItems
                }
              }
            }
          }
        }
      }
      userErrors {
        field
        code
        message
      }
    }
  }
QUERY

variables = {
  "automaticBasicDiscount": {
    "title": "$10 off orders over $100 (combinable with shipping discounts)",
    "startsAt": "2025-07-24T16:19:41-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "100.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "10.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    },
    "combinesWith": {
      "productDiscounts": false,
      "shippingDiscounts": true,
      "orderDiscounts": false
    }
  }
}

response = client.query(query: query, variables: variables)

Shopify CLI

shopify app execute \
--query \
'mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
  discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
    automaticDiscountNode {
      id
      automaticDiscount {
        ... on DiscountAutomaticBasic {
          title
          startsAt
          combinesWith {
            productDiscounts
            shippingDiscounts
            orderDiscounts
          }
          minimumRequirement {
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
                currencyCode
              }
            }
          }
          customerGets {
            value {
              ... on DiscountAmount {
                amount {
                  amount
                  currencyCode
                }
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}' \
--variables \
'{
  "automaticBasicDiscount": {
    "title": "$10 off orders over $100 (combinable with shipping discounts)",
    "startsAt": "2025-07-24T16:19:41-04:00",
    "minimumRequirement": {
      "subtotal": {
        "greaterThanOrEqualToSubtotal": "100.00"
      }
    },
    "customerGets": {
      "value": {
        "discountAmount": {
          "amount": "10.00",
          "appliesOnEachItem": false
        }
      },
      "items": {
        "all": true
      }
    },
    "combinesWith": {
      "productDiscounts": false,
      "shippingDiscounts": true,
      "orderDiscounts": false
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation discountAutomaticBasicCreate($automaticBasicDiscount: DiscountAutomaticBasicInput!) {
        discountAutomaticBasicCreate(automaticBasicDiscount: $automaticBasicDiscount) {
          automaticDiscountNode {
            id
            automaticDiscount {
              ... on DiscountAutomaticBasic {
                title
                startsAt
                combinesWith {
                  productDiscounts
                  shippingDiscounts
                  orderDiscounts
                }
                minimumRequirement {
                  ... on DiscountMinimumSubtotal {
                    greaterThanOrEqualToSubtotal {
                      amount
                      currencyCode
                    }
                  }
                }
                customerGets {
                  value {
                    ... on DiscountAmount {
                      amount {
                        amount
                        currencyCode
                      }
                    }
                  }
                  items {
                    ... on AllDiscountItems {
                      allItems
                    }
                  }
                }
              }
            }
          }
          userErrors {
            field
            code
            message
          }
        }
      }
    `,
    variables: {
        "automaticBasicDiscount": {
            "title": "$10 off orders over $100 (combinable with shipping discounts)",
            "startsAt": "2025-07-24T16:19:41-04:00",
            "minimumRequirement": {
                "subtotal": {
                    "greaterThanOrEqualToSubtotal": "100.00"
                }
            },
            "customerGets": {
                "value": {
                    "discountAmount": {
                        "amount": "10.00",
                        "appliesOnEachItem": false
                    }
                },
                "items": {
                    "all": true
                }
            },
            "combinesWith": {
                "productDiscounts": false,
                "shippingDiscounts": true,
                "orderDiscounts": false
            }
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Input variables

JSON

{

"automaticBasicDiscount": {

"title": "$10 off orders over $100 (combinable with shipping discounts)",

"startsAt": "2025-07-24T16:19:41-04:00",

"minimumRequirement": {

"subtotal": {

"greaterThanOrEqualToSubtotal": "100.00"

}

"customerGets": {

"value": {

"discountAmount": {

"amount": "10.00",

"appliesOnEachItem": false

}

"items": {

"all": true

}

"combinesWith": {

"productDiscounts": false,

"shippingDiscounts": true,

"orderDiscounts": false

}

Response

JSON

{

"discountAutomaticBasicCreate": {

"automaticDiscountNode": {

"id": "gid://shopify/DiscountAutomaticNode/1057856663",

"automaticDiscount": {

"title": "$10 off orders over $100 (combinable with shipping discounts)",

"startsAt": "2025-07-24T20:19:41Z",

"combinesWith": {

"productDiscounts": false,

"shippingDiscounts": true,

"orderDiscounts": false

"minimumRequirement": {

"greaterThanOrEqualToSubtotal": {

"amount": "100.0",

"currencyCode": "USD"

}

"customerGets": {

"value": {

"amount": {

"amount": "10.0",

"currencyCode": "USD"

}

"items": {

"allItems": true

}

"userErrors": []

}