---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    What this endpoint does: Creates a new recurring… Reference for the POST
    /projects/{projectId}/subscription-billings endpoint in the Leadtime Public
    API API.
sidebar:
  badge: POST
  label: Create project subscription billing
title: Create project subscription billing
type: openapi-operation
---
**What this endpoint does:**
Creates a new recurring subscription billing item for a project. The system automatically generates billing rows for each billing period based on your date range and frequency settings. These rows can later be included in invoices.

**How it works:**
1. Specify the date range (fromDate to toDate) for when the subscription is active
2. Set the frequency (1-12 months) to determine billing intervals:
   - 1 = monthly billing
   - 3 = quarterly billing
   - 6 = semi-annual billing
   - 12 = yearly billing
3. Choose the payment type:
   - **fixed**: Fixed amount per period (e.g., $500/month)
   - **perUnit**: Variable pricing (e.g., $50 per user per month)
   - **oneTime**: One-time charge (requires quantity field)
4. The system automatically:
   - Calculates sort order (display position)
   - Generates billing rows for each period within the date range
   - Creates date keys for invoice matching

**Validation rules:**
- fromDate must be before or equal to toDate
- Price must be positive
- Frequency must be between 1 and 12 months
- Quantity is required for oneTime payment type

**Permissions required:**
- Projects.edit: Ability to edit project settings
- Invoices.manage: Ability to manage invoice configurations

**Example use cases:**
- Set up monthly support package subscription
- Configure quarterly maintenance contract
- Add yearly license renewal
- Create variable pricing based on usage

<Operation source="api-reference" id="projectsubscriptionbillingscontroller-createsubscriptionbilling" />