---
title: SubscriptionBillingCycleInput - Customer API
description: >-
  The input fields for specifying the subscription contract and selecting the
  associated billing cycle.
api_version: 2026-04
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.billingCycleInput](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionBillingCycleSkip#arguments-billingCycleInput)

  ARGUMENT

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

  ARGUMENT

***

## Map

### Mutations using this input

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