---
title: SubscriptionBillingAttemptInput - GraphQL Admin
description: The input fields required to complete a subscription billing attempt.
api_version: 2025-10
api_name: admin
type: input-object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/input-objects/subscriptionbillingattemptinput
  md: https://shopify.dev/docs/api/admin-graphql/latest/input-objects/subscriptionbillingattemptinput.md
---

# Subscription​Billing​Attempt​Input

input\_object

The input fields required to complete a subscription billing attempt.

## Fields

* billing​Cycle​Selector

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

  Select the specific billing cycle to be billed. Default to bill the current billing cycle if not specified.

* idempotency​Key

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

  non-null

  A unique key generated by the client to avoid duplicate payments. For more information, refer to [Idempotent requests](https://shopify.dev/api/usage/idempotent-requests).

* inventory​Policy

  [Subscription​Billing​Attempt​Inventory​Policy](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingAttemptInventoryPolicy)

  Default:PRODUCT\_VARIANT\_INVENTORY\_POLICY

  The behaviour to follow when creating an order for a product variant when it's out of stock.

* origin​Time

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

  The date and time used to calculate fulfillment intervals for a billing attempt that successfully completed after the current anchor date. To prevent fulfillment from being pushed to the next anchor date, this field can override the billing attempt date.

***

## Map

No referencing types