# RecurringBillingSubscriptionAddOnInput

Input · GraphQL API

Input fields for an add-on on a subscription.

## Fields

- `addOnId` (`ID!`) — required: Required. The add-on template ID.
- `quantity` (`Int`): The quantity of this add-on. Defaults to 1.
- `amount` (`Amount`): The amount for this add-on.
- `numberOfBillingCycles` (`Int`): The number of times the billing cycle will be executed. Set to 0 to indicate the add-on never expires (bills indefinitely). Valid range: 0-999.

## Used by

- [RecurringBillingSubscriptionReplaceExistingModificationsInput](/braintree/graphql/reference/types/recurring-billing-subscription-replace-existing-modifications-input) — Input; addOns
- [RecurringBillingSubscriptionRetainExistingAddOnsInput](/braintree/graphql/reference/types/recurring-billing-subscription-retain-existing-add-ons-input) — Input; add, edit

## GraphQL definition

```graphql
input RecurringBillingSubscriptionAddOnInput {
  addOnId: ID!
  quantity: Int
  amount: Amount
  numberOfBillingCycles: Int
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)