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

# Accounts & Subscriptions

> Managing customer accounts and subscription lifecycles

## Accounts

An `account` represents a customer organization. When you create an account, you provide the company name, billing address, and contact information. Each account can have multiple contacts like billing contacts who receive invoices or technical contacts who get notifications.

## Subscriptions

A `subscription` connects a customer account to a `product` and `rate plan`. When you create a subscription, you select the account, choose the product and rate plan, and set the billing cycle. The subscription starts tracking usage and accumulating charges immediately.

You can update subscriptions anytime. Customers can upgrade or downgrade their rate plan, or change their billing cycle. When subscriptions change mid-cycle, charges are prorated automatically. You can pause subscriptions temporarily or cancel them permanently.

## Invoice Generation

Invoices are generated automatically at the end of each billing cycle. The system adds up all the `@outcome` and `@action` usage from that period, applies the charges from the rate plan, adds any discounts, and creates an invoice.