--- title: SubscriptionDraftUserError - GraphQL Admin description: Represents a Subscription Draft error. api_version: 2026-10 source_url: html: >- https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraftUserError md: >- https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraftUserError.md api_name: admin api_type: graphql type: object --- # Subscription​Draft​User​Error object Requires `read_own_subscription_contracts` access scope. Represents a Subscription Draft error. ## Fields * code [Subscription​Draft​Error​Code](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionDraftErrorCode) The error code. * field [\[String!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The path to the input field that caused the error. * message [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The error message. *** ## Map No referencing types *** ## Mutations * [subscription​Billing​Cycle​Contract​Draft​Commit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractDraftCommit) mutation Commits the updates of a Subscription Billing Cycle Contract draft. * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Contract draft to commit. *** * [subscription​Billing​Cycle​Contract​Draft​Concatenate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractDraftConcatenate) mutation Concatenates a contract to a Subscription Draft. * concatenated​Billing​Cycle​Contracts [\[Subscription​Billing​Cycle​Input!\]!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingCycleInput) required ### Arguments An array of Subscription Contracts with their selected billing cycles to concatenate to the subscription draft. * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The gid of the Subscription Contract draft to update. *** * [subscription​Billing​Cycle​Contract​Edit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEdit) mutation Edit the contents of a subscription contract for the specified billing cycle. * actor [Subscription​Actor](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor) ### Arguments The actor who initiated a subscription action. * billing​Cycle​Input [Subscription​Billing​Cycle​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingCycleInput) required Input object for selecting and using billing cycles. *** * [subscription​Contract​Atomic​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractAtomicCreate) mutation Creates a Subscription Contract. * input [Subscription​Contract​Atomic​Create​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractAtomicCreateInput) required ### Arguments The properties of the new Subscription Contract. *** * [subscription​Contract​Product​Change](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractProductChange) mutation Allows for the easy change of a Product in a Contract or a Product price change. * actor [Subscription​Actor](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor) ### Arguments The actor who initiated a subscription action. * input [Subscription​Contract​Product​Change​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractProductChangeInput) required The properties of the Product changes. * line​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The gid of the Subscription Line to update. * subscription​Contract​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The ID of the subscription contract. *** ### Deprecated mutations * [subscription​Contract​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreate) mutation Deprecated * input [Subscription​Contract​Create​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionContractCreateInput) required ### Arguments The properties of the new Subscription Contract. *** * [subscription​Contract​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdate) mutation Deprecated * actor [Subscription​Actor](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor) ### Arguments The actor who initiated a subscription action. * contract​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The gid of the Subscription Contract to update. *** * [subscription​Draft​Commit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftCommit) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Contract draft to commit. *** * [subscription​Draft​Discount​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountAdd) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The ID of the Subscription Contract draft to add a subscription discount to. * input [Subscription​Manual​Discount​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionManualDiscountInput) required The properties of the new Subscription Discount. *** * [subscription​Draft​Discount​Code​Apply](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountCodeApply) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the subscription contract draft to apply a subscription code discount on. * redeem​Code [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) required Code discount redeem code. *** * [subscription​Draft​Discount​Remove](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountRemove) mutation Deprecated * discount​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the subscription draft discount to remove. * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The gid of the subscription contract draft to remove a subscription discount from. *** * [subscription​Draft​Discount​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountUpdate) mutation Deprecated * discount​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Discount to update. * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The ID of the Subscription Contract draft to update a subscription discount on. * input [Subscription​Manual​Discount​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionManualDiscountInput) required The properties to update on the Subscription Discount. *** * [subscription​Draft​Free​Shipping​Discount​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftFreeShippingDiscountAdd) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The ID of the subscription contract draft to add a subscription free shipping discount to. * input [Subscription​Free​Shipping​Discount​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionFreeShippingDiscountInput) required The properties of the new subscription free shipping discount. *** * [subscription​Draft​Free​Shipping​Discount​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftFreeShippingDiscountUpdate) mutation Deprecated * discount​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Discount to update. * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The ID of the Subscription Contract draft to update a subscription discount on. * input [Subscription​Free​Shipping​Discount​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionFreeShippingDiscountInput) required The properties to update on the Subscription Free Shipping Discount. *** * [subscription​Draft​Line​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftLineAdd) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Contract draft to add a subscription line to. * input [Subscription​Line​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionLineInput) required The properties of the new Subscription Line. *** * [subscription​Draft​Line​Remove](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftLineRemove) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Contract draft to remove a subscription line from. * line​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The gid of the Subscription Line to remove. *** * [subscription​Draft​Line​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftLineUpdate) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Contract draft to update a subscription line from. * input [Subscription​Line​Update​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionLineUpdateInput) required The properties of the new Subscription Line. * line​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The gid of the Subscription Line to update. *** * [subscription​Draft​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftUpdate) mutation Deprecated * draft​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The gid of the Subscription Draft to update. * input [Subscription​Draft​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionDraftInput) required The properties of the new Subscription Contract. *** *** ## SubscriptionDraftUserError Mutations ### Mutated by * [subscription​Billing​Cycle​Contract​Draft​Commit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractDraftCommit) * [subscription​Billing​Cycle​Contract​Draft​Concatenate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractDraftConcatenate) * [subscription​Billing​Cycle​Contract​Edit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleContractEdit) * [subscription​Contract​Atomic​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractAtomicCreate) * [subscription​Contract​Product​Change](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractProductChange) *** ## Interfaces * [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError) interface *** ## SubscriptionDraftUserError Implements ### Implements * [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError)