---
title: subscriptionContractCreateCalculate - GraphQL Admin
description: >-
  Starts an asynchronous calculation for a new subscription contract. The

  contract isn't created until you commit the calculation.


  Poll the
  [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation)
  query to review the calculated contract, its projected order totals, and any

  warnings, then commit it with the
  [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit)
  mutation.


  Learn how to [build a subscription
  contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreateCalculate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreateCalculate.md
api_name: admin
api_type: graphql
type: mutation
---

# subscription​Contract​Create​Calculate

mutation

Requires `write_own_subscription_contracts` access scope. Also: The user must have manage\_orders\_information permission.

Starts an asynchronous calculation for a new subscription contract. The contract isn't created until you commit the calculation.

Poll the [`subscriptionContractCalculation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionContractCalculation) query to review the calculated contract, its projected order totals, and any warnings, then commit it with the [`subscriptionContractCalculationCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCalculationCommit) mutation.

Learn how to [build a subscription contract](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract).

## Arguments

* contract​Create​Input

  [Subscription​Contract​Calculation​Contract​Create​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractCreateInput)

  required

  The input for the new subscription contract calculation.

***

## Subscription​Contract​Create​Calculate​Payload returns

* subscription​Contract​Calculation

  [Subscription​Contract​Calculation](https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionContractCalculation)

  The result of the subscription contract calculation operation.

* user​Errors

  [\[Subscription​Contract​Create​Calculate​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContractCreateCalculateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### subscriptionContractCreateCalculate reference