---
title: SubscriptionBillingCycleInput - Customer API
description: The input fields for specifying the subscription contract and selecting the associated billing cycle.
api_version: 2025-10
api_name: customer
type: input-object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/input-objects/subscriptionbillingcycleinput
  md: https://shopify.dev/docs/api/customer/latest/input-objects/subscriptionbillingcycleinput.md
---

# Subscription​Billing​Cycle​Input

input\_object

The input fields for specifying the subscription contract and selecting the associated billing cycle.

## Fields

* contract​Id

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

  non-null

  The ID of the subscription contract associated with the billing cycle.

* selector

  [Subscription​Billing​Cycle​Selector!](https://shopify.dev/docs/api/customer/latest/input-objects/SubscriptionBillingCycleSelector)

  required

  Selects the billing cycle by date or index.

***

## Mutations using this input

* [subscription​Billing​Cycle​Skip.​billing​Cycle​Input](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionBillingCycleSkip#argument-billingCycleInput)

  MUTATION

* [subscription​Billing​Cycle​Unskip.​billing​Cycle​Input](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionBillingCycleUnskip#argument-billingCycleInput)

  MUTATION

***

## Map

### Mutations using this input

* <\~>[subscription​Billing​Cycle​Skip.billingCycleInput](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionBillingCycleSkip#argument-billingCycleInput)
* <\~>[subscription​Billing​Cycle​Unskip.billingCycleInput](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionBillingCycleUnskip#argument-billingCycleInput)