> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Subscription

Creates a new subscription for a customer.

<Warning>
  **Deprecated:** Use [provisionSubscriptionV2](/api-and-sdks/api-reference/mutations/provision-subscription) instead.
</Warning>

## Mutation

<CodeGroup>
  ```graphql Mutation theme={null}
  mutation CreateSubscription($input: SubscriptionInput!) {
    createSubscription(subscription: $input) {
      subscriptionId
      status
      plan {
        refId
        displayName
      }
      startDate
    }
  }
  ```

  ```json Variables theme={null}
  {
    "input": {
      "customerId": "customer-123",
      "planId": "plan-pro",
      "billingPeriod": "MONTHLY"
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "createSubscription": {
        "subscriptionId": "sub-789",
        "status": "ACTIVE",
        "plan": {
          "refId": "plan-pro",
          "displayName": "Pro Plan"
        },
        "startDate": "2024-01-15T00:00:00Z"
      }
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="input" type="SubscriptionInput" required>
  Input for creating a subscription

  <Expandable title="properties">
    <ParamField body="customerId" type="String" required>
      Customer reference ID
    </ParamField>

    <ParamField body="planId" type="String" required>
      Plan reference ID
    </ParamField>

    <ParamField body="billingPeriod" type="BillingPeriod">
      Billing period
    </ParamField>

    <ParamField body="addons" type="[SubscriptionAddonInput]">
      Addons to include
    </ParamField>

    <ParamField body="startDate" type="DateTime">
      Start date
    </ParamField>
  </Expandable>
</ParamField>

## Related Operations

* [Provision Subscription](/api-and-sdks/api-reference/mutations/provision-subscription) - Recommended alternative