---
title: discountAutomaticFreeShippingCreate - GraphQL Admin
description: >-
  Creates automatic free shipping discounts that apply to qualifying orders
  without requiring discount codes. These promotions automatically activate when
  customers meet specified criteria, streamlining the checkout experience.


  For example, a store might create an automatic free shipping discount for
  orders over variable pricing to encourage larger purchases, or offer free
  shipping to specific customer segments during promotional periods.


  Use `DiscountAutomaticFreeShippingCreate` to:

  - Set up code-free shipping promotions

  - Create order value-based shipping incentives

  - Target specific customer groups with shipping benefits

  - Establish location-based shipping discounts


  The mutation validates discount configuration and returns the created
  automatic discount node along with any configuration errors that need
  resolution.


  Learn more about [automatic
  discounts](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticNode).
api_version: unstable
api_name: admin
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/mutations/discountAutomaticFreeShippingCreate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/mutations/discountAutomaticFreeShippingCreate.md
---

# discount​Automatic​Free​Shipping​Create

mutation

Requires Apps must have `write_discounts` access scope.

Creates automatic free shipping discounts that apply to qualifying orders without requiring discount codes. These promotions automatically activate when customers meet specified criteria, streamlining the checkout experience.

For example, a store might create an automatic free shipping discount for orders over variable pricing to encourage larger purchases, or offer free shipping to specific customer segments during promotional periods.

Use `DiscountAutomaticFreeShippingCreate` to:

* Set up code-free shipping promotions
* Create order value-based shipping incentives
* Target specific customer groups with shipping benefits
* Establish location-based shipping discounts

The mutation validates discount configuration and returns the created automatic discount node along with any configuration errors that need resolution.

Learn more about [automatic discounts](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticNode).

## Arguments

* free​Shipping​Automatic​Discount

  [Discount​Automatic​Free​Shipping​Input!](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/DiscountAutomaticFreeShippingInput)

  required

  The input data used to create the automatic free shipping discount.

***

## Discount​Automatic​Free​Shipping​Create​Payload returns

* automatic​Discount​Node

  [Discount​Automatic​Node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/DiscountAutomaticNode)

  The automatic free shipping discount that was created.

* user​Errors

  [\[Discount​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/DiscountUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### Create a free shipping discount based on cart value

  #### Description

  Create an automatic \[free shipping discount]\(https://help.shopify.com/manual/discounts/discount-types/free-shipping) discount. This mutation creates a discount that applies free shipping to North America on orders with a subtotal of $50 or more. The discount can be \[combined]\(https://help.shopify.com/manual/discounts/combining-discounts/discount-combinations) with order and product discounts. The discount applies to one-time purchases and orders with a maximum shipping price of $200.

  #### Query

  ```graphql
  mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
      automaticDiscountNode {
        id
      }
      userErrors {
        field
        message
      }
    }
  }
  ```

  #### Variables

  ```json
  {
    "freeShippingAutomaticDiscount": {
      "title": "FREESHIPPING50",
      "startsAt": "2025-01-11T22:30:47Z",
      "endsAt": "2025-12-31T23:59:59Z",
      "destination": {
        "countries": {
          "add": [
            "CA",
            "US"
          ]
        }
      },
      "appliesOnOneTimePurchase": true,
      "maximumShippingPrice": "200",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "50"
        }
      },
      "combinesWith": {
        "orderDiscounts": true,
        "productDiscounts": true
      }
    }
  }
  ```

  #### cURL

  ```bash
  curl -X POST \
  https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \
  -H 'Content-Type: application/json' \
  -H 'X-Shopify-Access-Token: {access_token}' \
  -d '{
  "query": "mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) { discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) { automaticDiscountNode { id } userErrors { field message } } }",
   "variables": {
      "freeShippingAutomaticDiscount": {
        "title": "FREESHIPPING50",
        "startsAt": "2025-01-11T22:30:47Z",
        "endsAt": "2025-12-31T23:59:59Z",
        "destination": {
          "countries": {
            "add": [
              "CA",
              "US"
            ]
          }
        },
        "appliesOnOneTimePurchase": true,
        "maximumShippingPrice": "200",
        "minimumRequirement": {
          "subtotal": {
            "greaterThanOrEqualToSubtotal": "50"
          }
        },
        "combinesWith": {
          "orderDiscounts": true,
          "productDiscounts": true
        }
      }
    }
  }'
  ```

  #### React Router

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

  export const loader = async ({request}) => {
    const { admin } = await authenticate.admin(request);
    const response = await admin.graphql(
      `#graphql
    mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
      discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
        automaticDiscountNode {
          id
        }
        userErrors {
          field
          message
        }
      }
    }`,
    {
      variables: {
          "freeShippingAutomaticDiscount": {
              "title": "FREESHIPPING50",
              "startsAt": "2025-01-11T22:30:47Z",
              "endsAt": "2025-12-31T23:59:59Z",
              "destination": {
                  "countries": {
                      "add": [
                          "CA",
                          "US"
                      ]
                  }
              },
              "appliesOnOneTimePurchase": true,
              "maximumShippingPrice": "200",
              "minimumRequirement": {
                  "subtotal": {
                      "greaterThanOrEqualToSubtotal": "50"
                  }
              },
              "combinesWith": {
                  "orderDiscounts": true,
                  "productDiscounts": true
              }
          }
      },
    },
    );
    const json = await response.json();
    return json.data;
  }
  ```

  #### Ruby

  ```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 M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
      discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
        automaticDiscountNode {
          id
        }
        userErrors {
          field
          message
        }
      }
    }
  QUERY

  variables = {
    "freeShippingAutomaticDiscount": {
      "title": "FREESHIPPING50",
      "startsAt": "2025-01-11T22:30:47Z",
      "endsAt": "2025-12-31T23:59:59Z",
      "destination": {
        "countries": {
          "add": [
            "CA",
            "US"
          ]
        }
      },
      "appliesOnOneTimePurchase": true,
      "maximumShippingPrice": "200",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "50"
        }
      },
      "combinesWith": {
        "orderDiscounts": true,
        "productDiscounts": true
      }
    }
  }

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

  #### Node.js

  ```javascript
  const client = new shopify.clients.Graphql({session});
  const data = await client.query({
    data: {
      "query": `mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
        discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
          automaticDiscountNode {
            id
          }
          userErrors {
            field
            message
          }
        }
      }`,
      "variables": {
          "freeShippingAutomaticDiscount": {
              "title": "FREESHIPPING50",
              "startsAt": "2025-01-11T22:30:47Z",
              "endsAt": "2025-12-31T23:59:59Z",
              "destination": {
                  "countries": {
                      "add": [
                          "CA",
                          "US"
                      ]
                  }
              },
              "appliesOnOneTimePurchase": true,
              "maximumShippingPrice": "200",
              "minimumRequirement": {
                  "subtotal": {
                      "greaterThanOrEqualToSubtotal": "50"
                  }
              },
              "combinesWith": {
                  "orderDiscounts": true,
                  "productDiscounts": true
              }
          }
      },
    },
  });
  ```

  #### Shopify CLI

  ```bash
  shopify app execute \
  --query \
  'mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
      automaticDiscountNode {
        id
      }
      userErrors {
        field
        message
      }
    }
  }' \
  --variables \
  '{
    "freeShippingAutomaticDiscount": {
      "title": "FREESHIPPING50",
      "startsAt": "2025-01-11T22:30:47Z",
      "endsAt": "2025-12-31T23:59:59Z",
      "destination": {
        "countries": {
          "add": [
            "CA",
            "US"
          ]
        }
      },
      "appliesOnOneTimePurchase": true,
      "maximumShippingPrice": "200",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "50"
        }
      },
      "combinesWith": {
        "orderDiscounts": true,
        "productDiscounts": true
      }
    }
  }'
  ```

  #### Direct API Access

  ```javascript
  const response = await fetch('shopify:admin/api/unstable/graphql.json', {
    method: 'POST',
    body: JSON.stringify({
      query: `
        mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
          discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
            automaticDiscountNode {
              id
            }
            userErrors {
              field
              message
            }
          }
        }
      `,
      variables: {
          "freeShippingAutomaticDiscount": {
              "title": "FREESHIPPING50",
              "startsAt": "2025-01-11T22:30:47Z",
              "endsAt": "2025-12-31T23:59:59Z",
              "destination": {
                  "countries": {
                      "add": [
                          "CA",
                          "US"
                      ]
                  }
              },
              "appliesOnOneTimePurchase": true,
              "maximumShippingPrice": "200",
              "minimumRequirement": {
                  "subtotal": {
                      "greaterThanOrEqualToSubtotal": "50"
                  }
              },
              "combinesWith": {
                  "orderDiscounts": true,
                  "productDiscounts": true
              }
          }
      },
    }),
  });

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

  #### Response

  ```json
  {
    "discountAutomaticFreeShippingCreate": {
      "automaticDiscountNode": {
        "id": "gid://shopify/DiscountAutomaticNode/1057856669"
      },
      "userErrors": []
    }
  }
  ```

* ### Create a free shipping discount for 5+ items

  #### Description

  Create an automatic \[free shipping discount]\(https://help.shopify.com/manual/discounts/discount-types/free-shipping) discount. This mutation creates a discount that applies free shipping to all destinations on orders with 5 or more items.

  #### Query

  ```graphql
  mutation CreateFreeShippingDiscount($input: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $input) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticFreeShipping {
            title
            startsAt
            endsAt
            minimumRequirement {
              ... on DiscountMinimumQuantity {
                greaterThanOrEqualToQuantity
              }
            }
            destinationSelection {
              ... on DiscountCountryAll {
                allCountries
              }
            }
          }
        }
      }
      userErrors {
        field
        message
      }
    }
  }
  ```

  #### Variables

  ```json
  {
    "input": {
      "title": "FREESHIP5PLUS",
      "startsAt": "2025-01-01T00:00:00Z",
      "endsAt": "2025-12-31T23:59:59Z",
      "minimumRequirement": {
        "quantity": {
          "greaterThanOrEqualToQuantity": "5"
        }
      },
      "destination": {
        "all": true
      }
    }
  }
  ```

  #### cURL

  ```bash
  curl -X POST \
  https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \
  -H 'Content-Type: application/json' \
  -H 'X-Shopify-Access-Token: {access_token}' \
  -d '{
  "query": "mutation CreateFreeShippingDiscount($input: DiscountAutomaticFreeShippingInput!) { discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $input) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticFreeShipping { title startsAt endsAt minimumRequirement { ... on DiscountMinimumQuantity { greaterThanOrEqualToQuantity } } destinationSelection { ... on DiscountCountryAll { allCountries } } } } } userErrors { field message } } }",
   "variables": {
      "input": {
        "title": "FREESHIP5PLUS",
        "startsAt": "2025-01-01T00:00:00Z",
        "endsAt": "2025-12-31T23:59:59Z",
        "minimumRequirement": {
          "quantity": {
            "greaterThanOrEqualToQuantity": "5"
          }
        },
        "destination": {
          "all": true
        }
      }
    }
  }'
  ```

  #### React Router

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

  export const loader = async ({request}) => {
    const { admin } = await authenticate.admin(request);
    const response = await admin.graphql(
      `#graphql
    mutation CreateFreeShippingDiscount($input: DiscountAutomaticFreeShippingInput!) {
      discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $input) {
        automaticDiscountNode {
          id
          automaticDiscount {
            ... on DiscountAutomaticFreeShipping {
              title
              startsAt
              endsAt
              minimumRequirement {
                ... on DiscountMinimumQuantity {
                  greaterThanOrEqualToQuantity
                }
              }
              destinationSelection {
                ... on DiscountCountryAll {
                  allCountries
                }
              }
            }
          }
        }
        userErrors {
          field
          message
        }
      }
    }`,
    {
      variables: {
          "input": {
              "title": "FREESHIP5PLUS",
              "startsAt": "2025-01-01T00:00:00Z",
              "endsAt": "2025-12-31T23:59:59Z",
              "minimumRequirement": {
                  "quantity": {
                      "greaterThanOrEqualToQuantity": "5"
                  }
              },
              "destination": {
                  "all": true
              }
          }
      },
    },
    );
    const json = await response.json();
    return json.data;
  }
  ```

  #### Ruby

  ```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 CreateFreeShippingDiscount($input: DiscountAutomaticFreeShippingInput!) {
      discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $input) {
        automaticDiscountNode {
          id
          automaticDiscount {
            ... on DiscountAutomaticFreeShipping {
              title
              startsAt
              endsAt
              minimumRequirement {
                ... on DiscountMinimumQuantity {
                  greaterThanOrEqualToQuantity
                }
              }
              destinationSelection {
                ... on DiscountCountryAll {
                  allCountries
                }
              }
            }
          }
        }
        userErrors {
          field
          message
        }
      }
    }
  QUERY

  variables = {
    "input": {
      "title": "FREESHIP5PLUS",
      "startsAt": "2025-01-01T00:00:00Z",
      "endsAt": "2025-12-31T23:59:59Z",
      "minimumRequirement": {
        "quantity": {
          "greaterThanOrEqualToQuantity": "5"
        }
      },
      "destination": {
        "all": true
      }
    }
  }

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

  #### Node.js

  ```javascript
  const client = new shopify.clients.Graphql({session});
  const data = await client.query({
    data: {
      "query": `mutation CreateFreeShippingDiscount($input: DiscountAutomaticFreeShippingInput!) {
        discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $input) {
          automaticDiscountNode {
            id
            automaticDiscount {
              ... on DiscountAutomaticFreeShipping {
                title
                startsAt
                endsAt
                minimumRequirement {
                  ... on DiscountMinimumQuantity {
                    greaterThanOrEqualToQuantity
                  }
                }
                destinationSelection {
                  ... on DiscountCountryAll {
                    allCountries
                  }
                }
              }
            }
          }
          userErrors {
            field
            message
          }
        }
      }`,
      "variables": {
          "input": {
              "title": "FREESHIP5PLUS",
              "startsAt": "2025-01-01T00:00:00Z",
              "endsAt": "2025-12-31T23:59:59Z",
              "minimumRequirement": {
                  "quantity": {
                      "greaterThanOrEqualToQuantity": "5"
                  }
              },
              "destination": {
                  "all": true
              }
          }
      },
    },
  });
  ```

  #### Shopify CLI

  ```bash
  shopify app execute \
  --query \
  'mutation CreateFreeShippingDiscount($input: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $input) {
      automaticDiscountNode {
        id
        automaticDiscount {
          ... on DiscountAutomaticFreeShipping {
            title
            startsAt
            endsAt
            minimumRequirement {
              ... on DiscountMinimumQuantity {
                greaterThanOrEqualToQuantity
              }
            }
            destinationSelection {
              ... on DiscountCountryAll {
                allCountries
              }
            }
          }
        }
      }
      userErrors {
        field
        message
      }
    }
  }' \
  --variables \
  '{
    "input": {
      "title": "FREESHIP5PLUS",
      "startsAt": "2025-01-01T00:00:00Z",
      "endsAt": "2025-12-31T23:59:59Z",
      "minimumRequirement": {
        "quantity": {
          "greaterThanOrEqualToQuantity": "5"
        }
      },
      "destination": {
        "all": true
      }
    }
  }'
  ```

  #### Direct API Access

  ```javascript
  const response = await fetch('shopify:admin/api/unstable/graphql.json', {
    method: 'POST',
    body: JSON.stringify({
      query: `
        mutation CreateFreeShippingDiscount($input: DiscountAutomaticFreeShippingInput!) {
          discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $input) {
            automaticDiscountNode {
              id
              automaticDiscount {
                ... on DiscountAutomaticFreeShipping {
                  title
                  startsAt
                  endsAt
                  minimumRequirement {
                    ... on DiscountMinimumQuantity {
                      greaterThanOrEqualToQuantity
                    }
                  }
                  destinationSelection {
                    ... on DiscountCountryAll {
                      allCountries
                    }
                  }
                }
              }
            }
            userErrors {
              field
              message
            }
          }
        }
      `,
      variables: {
          "input": {
              "title": "FREESHIP5PLUS",
              "startsAt": "2025-01-01T00:00:00Z",
              "endsAt": "2025-12-31T23:59:59Z",
              "minimumRequirement": {
                  "quantity": {
                      "greaterThanOrEqualToQuantity": "5"
                  }
              },
              "destination": {
                  "all": true
              }
          }
      },
    }),
  });

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

  #### Response

  ```json
  {
    "discountAutomaticFreeShippingCreate": {
      "automaticDiscountNode": {
        "id": "gid://shopify/DiscountAutomaticNode/1057856671",
        "automaticDiscount": {
          "title": "FREESHIP5PLUS",
          "startsAt": "2025-01-01T00:00:00Z",
          "endsAt": "2025-12-31T23:59:59Z",
          "minimumRequirement": {
            "greaterThanOrEqualToQuantity": "5"
          },
          "destinationSelection": {
            "allCountries": true
          }
        }
      },
      "userErrors": []
    }
  }
  ```

* ### Create a free shipping discount for a customer segment

  #### Description

  Create an automatic \[free shipping discount]\(https://help.shopify.com/manual/discounts/discount-types/free-shipping) discount. This mutation creates a discount that applies free shipping to North America on orders with a subtotal of $50 or more. The discount can be \[combined]\(https://help.shopify.com/manual/discounts/combining-discounts/discount-combinations) with order and product discounts. The discount applies to one-time purchases and orders with a maximum shipping price of $200. This discount applies to customers from a particular segment.

  #### Query

  ```graphql
  mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
      automaticDiscountNode {
        id
      }
      userErrors {
        field
        message
      }
    }
  }
  ```

  #### Variables

  ```json
  {
    "freeShippingAutomaticDiscount": {
      "title": "FREESHIPPING50",
      "startsAt": "2025-07-24T16:21:30-04:00",
      "destination": {
        "countries": {
          "add": [
            "CA",
            "US"
          ]
        }
      },
      "context": {
        "customerSegments": {
          "add": [
            "gid://shopify/Segment/210588551"
          ]
        }
      },
      "appliesOnOneTimePurchase": true,
      "maximumShippingPrice": "200",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "50"
        }
      },
      "combinesWith": {
        "orderDiscounts": true,
        "productDiscounts": true
      }
    }
  }
  ```

  #### cURL

  ```bash
  curl -X POST \
  https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \
  -H 'Content-Type: application/json' \
  -H 'X-Shopify-Access-Token: {access_token}' \
  -d '{
  "query": "mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) { discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) { automaticDiscountNode { id } userErrors { field message } } }",
   "variables": {
      "freeShippingAutomaticDiscount": {
        "title": "FREESHIPPING50",
        "startsAt": "2025-07-24T16:21:30-04:00",
        "destination": {
          "countries": {
            "add": [
              "CA",
              "US"
            ]
          }
        },
        "context": {
          "customerSegments": {
            "add": [
              "gid://shopify/Segment/210588551"
            ]
          }
        },
        "appliesOnOneTimePurchase": true,
        "maximumShippingPrice": "200",
        "minimumRequirement": {
          "subtotal": {
            "greaterThanOrEqualToSubtotal": "50"
          }
        },
        "combinesWith": {
          "orderDiscounts": true,
          "productDiscounts": true
        }
      }
    }
  }'
  ```

  #### React Router

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

  export const loader = async ({request}) => {
    const { admin } = await authenticate.admin(request);
    const response = await admin.graphql(
      `#graphql
    mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
      discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
        automaticDiscountNode {
          id
        }
        userErrors {
          field
          message
        }
      }
    }`,
    {
      variables: {
          "freeShippingAutomaticDiscount": {
              "title": "FREESHIPPING50",
              "startsAt": "2025-07-24T16:21:30-04:00",
              "destination": {
                  "countries": {
                      "add": [
                          "CA",
                          "US"
                      ]
                  }
              },
              "context": {
                  "customerSegments": {
                      "add": [
                          "gid://shopify/Segment/210588551"
                      ]
                  }
              },
              "appliesOnOneTimePurchase": true,
              "maximumShippingPrice": "200",
              "minimumRequirement": {
                  "subtotal": {
                      "greaterThanOrEqualToSubtotal": "50"
                  }
              },
              "combinesWith": {
                  "orderDiscounts": true,
                  "productDiscounts": true
              }
          }
      },
    },
    );
    const json = await response.json();
    return json.data;
  }
  ```

  #### Ruby

  ```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 M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
      discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
        automaticDiscountNode {
          id
        }
        userErrors {
          field
          message
        }
      }
    }
  QUERY

  variables = {
    "freeShippingAutomaticDiscount": {
      "title": "FREESHIPPING50",
      "startsAt": "2025-07-24T16:21:30-04:00",
      "destination": {
        "countries": {
          "add": [
            "CA",
            "US"
          ]
        }
      },
      "context": {
        "customerSegments": {
          "add": [
            "gid://shopify/Segment/210588551"
          ]
        }
      },
      "appliesOnOneTimePurchase": true,
      "maximumShippingPrice": "200",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "50"
        }
      },
      "combinesWith": {
        "orderDiscounts": true,
        "productDiscounts": true
      }
    }
  }

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

  #### Node.js

  ```javascript
  const client = new shopify.clients.Graphql({session});
  const data = await client.query({
    data: {
      "query": `mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
        discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
          automaticDiscountNode {
            id
          }
          userErrors {
            field
            message
          }
        }
      }`,
      "variables": {
          "freeShippingAutomaticDiscount": {
              "title": "FREESHIPPING50",
              "startsAt": "2025-07-24T16:21:30-04:00",
              "destination": {
                  "countries": {
                      "add": [
                          "CA",
                          "US"
                      ]
                  }
              },
              "context": {
                  "customerSegments": {
                      "add": [
                          "gid://shopify/Segment/210588551"
                      ]
                  }
              },
              "appliesOnOneTimePurchase": true,
              "maximumShippingPrice": "200",
              "minimumRequirement": {
                  "subtotal": {
                      "greaterThanOrEqualToSubtotal": "50"
                  }
              },
              "combinesWith": {
                  "orderDiscounts": true,
                  "productDiscounts": true
              }
          }
      },
    },
  });
  ```

  #### Shopify CLI

  ```bash
  shopify app execute \
  --query \
  'mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
      automaticDiscountNode {
        id
      }
      userErrors {
        field
        message
      }
    }
  }' \
  --variables \
  '{
    "freeShippingAutomaticDiscount": {
      "title": "FREESHIPPING50",
      "startsAt": "2025-07-24T16:21:30-04:00",
      "destination": {
        "countries": {
          "add": [
            "CA",
            "US"
          ]
        }
      },
      "context": {
        "customerSegments": {
          "add": [
            "gid://shopify/Segment/210588551"
          ]
        }
      },
      "appliesOnOneTimePurchase": true,
      "maximumShippingPrice": "200",
      "minimumRequirement": {
        "subtotal": {
          "greaterThanOrEqualToSubtotal": "50"
        }
      },
      "combinesWith": {
        "orderDiscounts": true,
        "productDiscounts": true
      }
    }
  }'
  ```

  #### Direct API Access

  ```javascript
  const response = await fetch('shopify:admin/api/unstable/graphql.json', {
    method: 'POST',
    body: JSON.stringify({
      query: `
        mutation M($freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
          discountAutomaticFreeShippingCreate(freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
            automaticDiscountNode {
              id
            }
            userErrors {
              field
              message
            }
          }
        }
      `,
      variables: {
          "freeShippingAutomaticDiscount": {
              "title": "FREESHIPPING50",
              "startsAt": "2025-07-24T16:21:30-04:00",
              "destination": {
                  "countries": {
                      "add": [
                          "CA",
                          "US"
                      ]
                  }
              },
              "context": {
                  "customerSegments": {
                      "add": [
                          "gid://shopify/Segment/210588551"
                      ]
                  }
              },
              "appliesOnOneTimePurchase": true,
              "maximumShippingPrice": "200",
              "minimumRequirement": {
                  "subtotal": {
                      "greaterThanOrEqualToSubtotal": "50"
                  }
              },
              "combinesWith": {
                  "orderDiscounts": true,
                  "productDiscounts": true
              }
          }
      },
    }),
  });

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

  #### Response

  ```json
  {
    "discountAutomaticFreeShippingCreate": {
      "automaticDiscountNode": {
        "id": "gid://shopify/DiscountAutomaticNode/1057856670"
      },
      "userErrors": []
    }
  }
  ```

* ### discountAutomaticFreeShippingCreate reference