---
title: SubscriptionContractCalculationContractCreateInput - GraphQL Admin
description: >-
  The input fields for calculating a new subscription contract. Provide the

  complete desired state of the contract. The contract isn't created until you

  commit the calculation 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/input-objects/SubscriptionContractCalculationContractCreateInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationContractCreateInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Subscription​Contract​Calculation​Contract​Create​Input

input\_object

The input fields for calculating a new subscription contract. Provide the complete desired state of the contract. The contract isn't created until you commit the calculation 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).

## Fields

* actor

  [Subscription​Actor](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor)

  The actor who initiated a subscription action.

* app​Managed​Billing​Config

  [Subscription​Contract​Calculation​App​Managed​Billing​Config​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCalculationAppManagedBillingConfigInput)

  App-managed billing configuration for the contract.

* billing​Policy

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

  required

  The billing policy for the new contract.

* currency​Code

  [Currency​Code!](https://shopify.dev/docs/api/admin-graphql/latest/enums/CurrencyCode)

  non-null

  The currency code for the new subscription contract.

* custom​Attributes

  [\[Attribute​Input!\]!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AttributeInput)

  requiredDefault:\[]

  The custom attributes for the new contract.

* customer​Id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  The ID of the customer to associate with the new subscription contract.

* delivery​Method

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

  required

  The delivery method for the new contract. Provide `none` for digital-only subscriptions. Provide `fetchAvailableDeliveryOptions` instead of a method to discover options for an address without committing a delivery method.

* delivery​Policy

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

  required

  The delivery policy for the new contract.

* discount​Codes

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

  requiredDefault:\[]

  The discount codes to apply during this calculation. Applied codes are resolved into manual discounts on the resulting contract. Defaults to an empty array (apply no discount codes).

* lines

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

  required

  The subscription lines for the new contract.

* manual​Discounts

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

  required

  The manual order and delivery discounts for the new contract. Provide an empty array for no manual discounts.

* note

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The note for the new contract.

* payment​Method

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

  required

  The payment method for the new contract. Provide `none` if no payment method is specified.

* with​Merchandise​Customizations

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Specifies whether to use merchandise customizations in the calculation.

***

## Mutations using this input

* [subscription​Contract​Create​Calculate.contractCreateInput](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreateCalculate#arguments-contractCreateInput)

  ARGUMENT

***

## Map

### Mutations using this input

* [subscription​Contract​Create​Calculate.contractCreateInput](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreateCalculate#arguments-contractCreateInput)