subscriptionContractProductChange

mutation

Requires write_own_subscription_contracts access scope. Also: The user must have manage_orders_information permission.

Allows for the easy change of a Product in a Contract or a Product price change.

Arguments

Anchor to inputinput • SubscriptionContractProductChangeInput!required: The properties of the Product changes.
Anchor to lineIdlineId • ID!required: The gid of the Subscription Line to update.
Anchor to subscriptionContractIdsubscriptionContractId • ID!required: The ID of the subscription contract.

Was this section helpful?

Anchor to SubscriptionContractProductChangePayload returnsSubscriptionContractProductChangePayload returns

Anchor to contractcontract • SubscriptionContract: The new Subscription Contract object.
Anchor to lineUpdatedlineUpdated • SubscriptionLine: The updated Subscription Line.
Anchor to userErrorsuserErrors • [SubscriptionDraftUserError!]!non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Update both product and price in a subscription contract
subscriptionContractProductChange reference

Examples

1const { admin } = await authenticate.admin(request);
2
3const response = await admin.graphql(
4  `#graphql
5  mutation($contractId: ID!, $lineId: ID!, $variantId: ID!) {
6    subscriptionContractProductChange(subscriptionContractId: $contractId, lineId: $lineId, input: {productVariantId: $variantId, currentPrice: 500}) {
7      contract {
8        id
9        updatedAt
10      }
11      lineUpdated {
12        id
13        currentPrice {
14          amount
15        }
16        variantId
17      }
18      userErrors {
19        field
20        message
21        code
22      }
23    }
24  }`,
25  {
26    variables: {
27      "contractId": "gid://shopify/SubscriptionContract/593791907",
28      "lineId": "gid://shopify/SubscriptionLine/25476bfc-b794-4ff5-b41f-7a00eb252d55",
29      "variantId": "gid://shopify/ProductVariant/30322695"
30    },
31  },
32);
33
34const data = await response.json();
35

mutation($contractId: ID!, $lineId: ID!, $variantId: ID!) {
  subscriptionContractProductChange(subscriptionContractId: $contractId, lineId: $lineId, input: {productVariantId: $variantId, currentPrice: 500}) {
    contract {
      id
      updatedAt
    }
    lineUpdated {
      id
      currentPrice {
        amount
      }
      variantId
    }
    userErrors {
      field
      message
      code
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation($contractId: ID!, $lineId: ID!, $variantId: ID!) { subscriptionContractProductChange(subscriptionContractId: $contractId, lineId: $lineId, input: {productVariantId: $variantId, currentPrice: 500}) { contract { id updatedAt } lineUpdated { id currentPrice { amount } variantId } userErrors { field message code } } }",
 "variables": {
    "contractId": "gid://shopify/SubscriptionContract/593791907",
    "lineId": "gid://shopify/SubscriptionLine/25476bfc-b794-4ff5-b41f-7a00eb252d55",
    "variantId": "gid://shopify/ProductVariant/30322695"
  }
}'

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

const response = await admin.graphql(
  `#graphql
  mutation($contractId: ID!, $lineId: ID!, $variantId: ID!) {
    subscriptionContractProductChange(subscriptionContractId: $contractId, lineId: $lineId, input: {productVariantId: $variantId, currentPrice: 500}) {
      contract {
        id
        updatedAt
      }
      lineUpdated {
        id
        currentPrice {
          amount
        }
        variantId
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
      "contractId": "gid://shopify/SubscriptionContract/593791907",
      "lineId": "gid://shopify/SubscriptionLine/25476bfc-b794-4ff5-b41f-7a00eb252d55",
      "variantId": "gid://shopify/ProductVariant/30322695"
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation($contractId: ID!, $lineId: ID!, $variantId: ID!) {
      subscriptionContractProductChange(subscriptionContractId: $contractId, lineId: $lineId, input: {productVariantId: $variantId, currentPrice: 500}) {
        contract {
          id
          updatedAt
        }
        lineUpdated {
          id
          currentPrice {
            amount
          }
          variantId
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
      "contractId": "gid://shopify/SubscriptionContract/593791907",
      "lineId": "gid://shopify/SubscriptionLine/25476bfc-b794-4ff5-b41f-7a00eb252d55",
      "variantId": "gid://shopify/ProductVariant/30322695"
    },
  },
});

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($contractId: ID!, $lineId: ID!, $variantId: ID!) {
    subscriptionContractProductChange(subscriptionContractId: $contractId, lineId: $lineId, input: {productVariantId: $variantId, currentPrice: 500}) {
      contract {
        id
        updatedAt
      }
      lineUpdated {
        id
        currentPrice {
          amount
        }
        variantId
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "contractId": "gid://shopify/SubscriptionContract/593791907",
  "lineId": "gid://shopify/SubscriptionLine/25476bfc-b794-4ff5-b41f-7a00eb252d55",
  "variantId": "gid://shopify/ProductVariant/30322695"
}

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

Input variables

JSON

1{
2  "contractId": "gid://shopify/SubscriptionContract/593791907",
3  "lineId": "gid://shopify/SubscriptionLine/25476bfc-b794-4ff5-b41f-7a00eb252d55",
4  "variantId": "gid://shopify/ProductVariant/30322695"
5}

Response

JSON

1{
2  "subscriptionContractProductChange": {
3    "contract": {
4      "id": "gid://shopify/SubscriptionContract/593791907",
5      "updatedAt": "2024-09-12T01:09:12Z"
6    },
7    "lineUpdated": {
8      "id": "gid://shopify/SubscriptionLine/25476bfc-b794-4ff5-b41f-7a00eb252d55",
9      "currentPrice": {
10        "amount": "500.0"
11      },
12      "variantId": "gid://shopify/ProductVariant/30322695"
13    },
14    "userErrors": []
15  }
16}