# RecurringBillingSubscriptionStartDateInput

Input · GraphQL API

Input fields for specifying the billing start date for a subscription. Exactly one field must be provided.

This is a one-of input.

## Fields

- `firstBillingDate` (`Date`): The date the subscription starts billing. Must be a future date. Dates are interpreted as UTC.
- `billingDayOfMonth` (`Int`): The day of the month the subscription will be charged on every billing cycle. Must be 1-28 or 31. A value of 31 charges on the last day of the month. For dates 29 or 30, use 31 (last day of month) to avoid validation errors.
- `trial` (`RecurringBillingSubscriptionTrialInput`): Trial period configuration. Overrides the plan's default trial settings.

## Used by

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

## GraphQL definition

```graphql
input RecurringBillingSubscriptionStartDateInput @oneOf {
  firstBillingDate: Date
  billingDayOfMonth: Int
  trial: RecurringBillingSubscriptionTrialInput
}
```

---

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