# createRecurringBillingSubscriptionPlan

Mutation · GraphQL API

Creates a new recurring billing subscription plan template that subscriptions can be based upon.

## Authentication

- SERVER

## Input

- `input` (`CreateRecurringBillingSubscriptionPlanInput!`) — required

## Returns [RecurringBillingSubscriptionPlanPayload](/braintree/graphql/reference/types/recurring-billing-subscription-plan-payload)

The response object returned after a recurring billing subscription plan mutation.

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.
- `plan` (`RecurringBillingSubscriptionPlan`): The plan that was created or updated.

## Examples

### Create recurring billing subscription plan

Top-level input fields for creating a recurring billing subscription plan.

```graphql
mutation createRecurringBillingSubscriptionPlan($input: CreateRecurringBillingSubscriptionPlanInput!) {
  createRecurringBillingSubscriptionPlan(input: $input) {
    clientMutationId
    plan {
      __typename
      id
      legacyId
      name
      description
      price {
        value
        currencyCode
      }
      billingFrequency
      billingDayOfMonth
      numberOfBillingCycles
      trial {
        duration
        durationUnit
      }
      addOns {
        __typename
        id
        legacyId
      }
      discounts {
        __typename
        id
        legacyId
      }
      createdAt
      updatedAt
    }
  }
}
```

---

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