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

# Getting Started

> Configure your first usage-based subscription

To configure a usage-based subscription, you first need to connect your data as Hyperline will need some dataset for you to configure usage-based products. If it's not done already, you can use a [CSV file](./import-events-csv), our [API](./send-usage-data) ou [data loaders](./usage-data-with-connectors).

When your first events have arrived, you'll be able to create a usage-based product [here](https://app.hyperline.co/app/products/create/select/).

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage-sub-1.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=e53bb6683ffb8749388895566de0ce79" width="2376" height="1204" data-path="images/usage/usage-sub-1.png" />
</Frame>

Select the usage based product, then link an [aggregator](./aggregators) to attach your product to the data you want to bill. If you haven't created an aggregator yet, head to **Usage > Aggregators** first. To know more about metering configuration, take a look at our [product catalog guide](../products/overview#usage).

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage-sub-2.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=579f493bbeb7b4234809344e9c621c48" width="1822" height="1632" data-path="images/usage/usage-sub-2.png" />
</Frame>

Once the product is setup and at least one recurring price is defined, you'll be able to assign it to a subscription.

Head over to the subscription tabs and click on [new subscription](https://app.hyperline.co/app/subscriptions/create), select your customer and then click on add product.

Select your product, an interface will appear for you to configure prices, the subscription schedule and various parameters.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage-sub-3.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=84a08346c3e8f82052b68d5ad8a2c1b8" width="1786" height="1332" data-path="images/usage/usage-sub-3.png" />
</Frame>

If you want to learn more about metering options on a subscription, read our [metering guide](../products/metering).

Click on payment settings and assign the subscription using the `Manually later` option, you'll be redirected to the customer page, the subscription should display the current usage.

If you're in [test mode](../getting-started/sandbox), you'll be able to simulate new events directly from the "events" tab.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage-sub-4.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=a0f720743fb0d690c8cf5be11d238601" width="2604" height="1224" data-path="images/usage/usage-sub-4.png" />
</Frame>

If you want to explore your consumption, you can click on the little eye icon next to the unit count, it will open the live consumption modal and will give you the detail of your consumption.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage-sub-5.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=8661ffe3e6a6e6bd7a02ebdb2122f1f9" width="2492" height="1476" data-path="images/usage/usage-sub-5.png" />
</Frame>

And done! Feel free to browse our documentation specific to subscriptions or to contact us on Intercom to get some help on your use case!
