# RecurringBillingSubscriptionOptionsInput

Input · GraphQL API

Input fields for specifying when the subscription starts billing.

## Fields

- `startImmediately` (`Boolean`): When true, starts the subscription immediately, overriding the plan's default start date settings. When false, the plan's default settings apply unless startDate is also provided. Cannot be true when startDate is also provided.
- `startDate` (`RecurringBillingSubscriptionStartDateInput`): The specific date configuration for when the subscription starts billing. Exactly one field must be provided. Cannot be combined with startImmediately: true.

## Used by

- [CreateRecurringBillingSubscriptionInput](/braintree/graphql/reference/types/create-recurring-billing-subscription-input) — Input; options

## GraphQL definition

```graphql
input RecurringBillingSubscriptionOptionsInput {
  startImmediately: Boolean
  startDate: RecurringBillingSubscriptionStartDateInput
}
```

---

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