Choose a version:

discountAutomaticFreeShippingUpdate

mutation

Requires Apps must have write_discounts access scope.

Updates an existing free shipping discount that's automatically applied on a cart and at checkout.

Note

To update code discounts, use the discountCodeFreeShippingUpdate mutation instead.

Arguments

Anchor to freeShippingAutomaticDiscountfreeShippingAutomaticDiscount • DiscountAutomaticFreeShippingInput!required: The input data used to update the automatic free shipping discount.
Anchor to idid • ID!required: The ID of the automatic free shipping discount to update.

Was this section helpful?

Anchor to DiscountAutomaticFreeShippingUpdatePayload returnsDiscountAutomaticFreeShippingUpdatePayload returns

Anchor to automaticDiscountNodeautomaticDiscountNode • DiscountAutomaticNode: The automatic discount that was updated.
Anchor to userErrorsuserErrors • [DiscountUserError!]!non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Update an automatic free shipping discount
Updates an existing a price rule
discountAutomaticFreeShippingUpdate reference

Examples

Open in GraphiQL

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

const response = await admin.graphql(

`#graphql

mutation M($id: ID!, $freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {

discountAutomaticFreeShippingUpdate(id: $id, freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {

automaticDiscountNode {

automaticDiscount {

... on DiscountAutomaticFreeShipping {

title

}

userErrors {

message

field

code

}

}`,

{

variables: {

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

"freeShippingAutomaticDiscount": {

"title": "A new title"

}

);

const data = await response.json();

mutation M($id: ID!, $freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
  discountAutomaticFreeShippingUpdate(id: $id, freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
    automaticDiscountNode {
      automaticDiscount {
        ... on DiscountAutomaticFreeShipping {
          title
        }
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation M($id: ID!, $freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) { discountAutomaticFreeShippingUpdate(id: $id, freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) { automaticDiscountNode { automaticDiscount { ... on DiscountAutomaticFreeShipping { title } } } userErrors { message field code } } }",
 "variables": {
    "id": "gid://shopify/DiscountAutomaticNode/1057371302",
    "freeShippingAutomaticDiscount": {
      "title": "A new title"
    }
  }
}'

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

const response = await admin.graphql(
  `#graphql
  mutation M($id: ID!, $freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingUpdate(id: $id, freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
      automaticDiscountNode {
        automaticDiscount {
          ... on DiscountAutomaticFreeShipping {
            title
          }
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }`,
  {
    variables: {
      "id": "gid://shopify/DiscountAutomaticNode/1057371302",
      "freeShippingAutomaticDiscount": {
        "title": "A new title"
      }
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation M($id: ID!, $freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
      discountAutomaticFreeShippingUpdate(id: $id, freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
        automaticDiscountNode {
          automaticDiscount {
            ... on DiscountAutomaticFreeShipping {
              title
            }
          }
        }
        userErrors {
          message
          field
          code
        }
      }
    }`,
    "variables": {
      "id": "gid://shopify/DiscountAutomaticNode/1057371302",
      "freeShippingAutomaticDiscount": {
        "title": "A new title"
      }
    },
  },
});

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($id: ID!, $freeShippingAutomaticDiscount: DiscountAutomaticFreeShippingInput!) {
    discountAutomaticFreeShippingUpdate(id: $id, freeShippingAutomaticDiscount: $freeShippingAutomaticDiscount) {
      automaticDiscountNode {
        automaticDiscount {
          ... on DiscountAutomaticFreeShipping {
            title
          }
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/DiscountAutomaticNode/1057371302",
  "freeShippingAutomaticDiscount": {
    "title": "A new title"
  }
}

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

Input variables

JSON

{

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

"freeShippingAutomaticDiscount": {

"title": "A new title"

}

Response

JSON

{

"discountAutomaticFreeShippingUpdate": {

"automaticDiscountNode": {

"automaticDiscount": {

"title": "A new title"

}

"userErrors": []

}