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

# Create Subscription

> Create new subscriptions for your customers

<Tabs>
  <Tab title="Web App">
    In Fynn, subscriptions can be created via the web app. Various options and settings can be configured for the subscription.

    <Steps>
      <Step title="Create Subscription">
        Click on the "+" symbol in the upper right corner and select `Subscription`.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/plus-create-shortcut.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=37d9ba4615650166518f1c6d1afe0806" alt="Create subscription" width="360px" data-path="images/plus-create-shortcut.png" />
        </Frame>
      </Step>

      <Step title="Configure Subscription">
        Configure the subscription with the desired settings and options. Various settings and options can be configured, such as:

        * **Customer**: Select the customer to whom the subscription should be assigned.
        * **Products**: Select the products to be included in the subscription.
        * **Billing Date**: Select the billing date when the subscription should be billed.
        * **Term**: Select the term of the subscription.
      </Step>

      <Step title="Add Products">
        Click on `Add Product` to select the desired products to be included in the subscription.
        Select the desired products from the list and click `Add` to add the products to the subscription.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/subscription-new-select-product.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=4a0a3a6eab67316e390b97be3913efd5" alt="Add products" width="1413" height="624" data-path="images/subscription-new-select-product.png" />
        </Frame>

        If a product contains multiple prices, you can select the desired prices to be included in the subscription here.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/product-price-select-dialog.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=9ec1c8704bceb8a179a606230c511f22" alt="Configure product prices" width="820" height="536" data-path="images/product-price-select-dialog.png" />
        </Frame>

        The products will then be added to the subscription and you can set the quantities and other settings for the products.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/subscription-new-products.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=8f699db0f3c1dc672faa1bd30ff278fc" alt="Products added" width="789" height="212" data-path="images/subscription-new-products.png" />
        </Frame>
      </Step>

      <Step title="Adjust Billing Details">
        Adjust the billing details:

        * **Contract Start**: The contract start is relevant for calculating cancellation periods and the earliest possible cancellation dates, in connection with the subscription terms.
        * **Billing Start**: The billing start is the date when the subscription will be billed. By default, this corresponds to the contract start. However, if the subscription is being migrated from a legacy system, for example, this should be set to the date when the subscription should be billed next. The billing interval is determined from this date.
        * **Contract End**: If it is already known at the beginning of the subscription when it should end, the contract end can be specified here. Otherwise, a subscription can be manually cancelled in the future.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/subscription-new-options-basic.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=fff1af0aa97d5deccf41a7b694264b08" alt="Adjust billing details" width="780" height="281" data-path="images/subscription-new-options-basic.png" />
        </Frame>
      </Step>

      <Step title="Adjust Advanced Billing Details">
        Adjust the advanced billing details:

        * **Order Number / PO Number**: Enter the order number or PO number to be assigned to the subscription. The PO number is always displayed on the invoice.
        * **Billing Group**: With the billing group, you can combine multiple subscriptions into a group. This way, subscriptions are billed together and summarized on one invoice. More details can be found at [Billing Groups](/en/guide/subscriptions/billing-groups).
        * **Subscription Number**: By default, the subscription number is automatically generated. However, you can enter a custom subscription number here.
        * **Custom Name**: Enter a custom name for the subscription here. This name is displayed on the invoice and in the subscription overview. By default, the subscription number is used as the name.
        * **External ID**: Enter an external ID to be assigned to the subscription. This ID is used in the API and webhook to identify the subscription.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/subscription-new-options-advanced.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=953ac0df738d45b62fa3c9a9414ea2bb" alt="Adjust advanced billing details" width="746" height="570" data-path="images/subscription-new-options-advanced.png" />
        </Frame>
      </Step>

      <Step title="Adjust Terms">
        Adjust the terms of the subscription. You can add any number of terms and adjust the cancellation periods.

        * **Contract Term**: Select the contract term of the subscription. By default, the contract term is set to 1 year.
        * **Cancellation Period**: Select the cancellation period of the subscription. By default, the cancellation period is set to 14 days.

        These periods can be individually adjusted for each subscription and are relevant for calculating the earliest possible cancellation date.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/subscription-new-options-terms.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=23bf687f2d352c6385ec32c8c5b482ef" alt="Adjust terms" width="780" height="272" data-path="images/subscription-new-options-terms.png" />
        </Frame>
      </Step>

      <Step title="Create Subscription">
        Review the subscription and click `Start Subscription` to create the subscription. The subscription will then be created and billed.

        Alternatively, you can:

        * save the subscription as a draft and create it at a later time
        * activate a trial period
        * create an offer for the subscription
      </Step>
    </Steps>
  </Tab>

  <Tab title="Use API">
    Use the [Create Subscription](/api-reference/subscription/create-subscription) endpoint for this.

    ```bash theme={null}
    POST /subscriptions
    ```
  </Tab>
</Tabs>

## Adjust Billing Start

The billing start is the date when the subscription is first billed. By default, the billing start corresponds to the contract start. However, if the subscription is being migrated from a legacy system, for example, this should be set to the date when the subscription should be billed next. The billing interval begins from this date.

If the billing start is set in the past, the subscription will be billed retroactively.

<Tip>
  Billing for all past billing cycles occurs immediately and within one invoice. After that, the subscription will be billed at the next billing date.
</Tip>
