---
title: subscriptionContractSetNextBillingDate - GraphQL Admin
description: |-
  Sets the next billing date of a Subscription Contract. This field is managed by the apps.
          Alternatively you can utilize our
          [Billing Cycles APIs](https://shopify.dev/docs/apps/selling-strategies/subscriptions/billing-cycles),
          which provide auto-computed billing dates and additional functionalities.
api_version: 2025-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptioncontractsetnextbillingdate
  md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptioncontractsetnextbillingdate.md
---

# subscription​Contract​Set​Next​Billing​Date

mutation

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

Sets the next billing date of a Subscription Contract. This field is managed by the apps. Alternatively you can utilize our [Billing Cycles APIs](https://shopify.dev/docs/apps/selling-strategies/subscriptions/billing-cycles), which provide auto-computed billing dates and additional functionalities.

## Arguments

* contract​Id

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

  required

  The gid of the Subscription Contract to set the next billing date for.

* date

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  required

  The next billing date.

***

## Subscription​Contract​Set​Next​Billing​Date​Payload returns

* contract

  [Subscription​Contract](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract)

  The updated Subscription Contract object.

* user​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### subscriptionContractSetNextBillingDate reference

## Mutation Reference

```graphql
mutation subscriptionContractSetNextBillingDate($contractId: ID!, $date: DateTime!) {
  subscriptionContractSetNextBillingDate(contractId: $contractId, date: $date) {
    contract {
      # SubscriptionContract fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "contractId": "gid://shopify/<objectName>/10079785100",
  "date": "2019-09-07T15:50:00Z"
}
```

##### Variables

```
{
  "contractId": "gid://shopify/<objectName>/10079785100",
  "date": "2019-09-07T15:50:00Z"
}
```