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

# Create recurring bill item

### Request

<ParamField body="leaseId" type="string" required>
  The lease for which recurring bill items will be created
</ParamField>

<ParamField body="recurringBillItem" type="object" required>
  <Expandable>
    <ParamField body="productKey" type="string" required>
      The key or identifier for the product or service billed (e.g., "key:rent")
    </ParamField>

    <ParamField body="description" type="string">
      The content of the description that is going to be put on the bill
    </ParamField>

    <ParamField body="amount" type="object" required>
      The amount charged for the recurring bill item

      <Expandable>
        <ParamField body="currency" type="string" required>
          The currency code for the recurring bill item amount (e.g., "DKK")
        </ParamField>

        <ParamField body="amount" type="number" required>
          The amount of the recurring bill item amount (e.g., 100.00)
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="quantity" type="Number">
      The quantity of items that is going to be put on the bill
    </ParamField>

    <ParamField body="vat" type="object" required>
      The VAT details for the recurring bill item

      <Expandable>
        <ParamField body="taxMode" type="string" required>
          The tax mode for the VAT (e.g., "Exempt", "Exclusive")
        </ParamField>

        <ParamField body="taxRate" type="number">
          The tax rate for the VAT (e.g., 0.25)
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="dueDateRule" type="object" required>
      The rule used to calculate the due date

      <Expandable>
        <ParamField body="dayOfPeriod" type="integer" required>
          The day of the period when the due date is calculated (e.g., 1 for the first day after period starts, -1 for the last day before period starts)
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="billingCycle" type="object" required>
      <Expandable>
        <ParamField body="timeUnit" type="string" required>
          Time unit based on which the billing cycle is calculated ("Month")
        </ParamField>

        <ParamField body="periodLength" type="integer" required>
          The number of time units in the billing cycle (e.g., 1 month, 3 months)
        </ParamField>

        <ParamField body="start" type="integer" required>
          Index of what day within the billing period the cycle starts (usually 1 for the first day of the period)
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="startedOn" type="date" required>
      First due date for the recurring bill item in ISO 8601 format
    </ParamField>

    <ParamField body="firstBillingPeriodBillItem" type="object" required>
      <Expandable>
        <ParamField body="amount" type="object" required>
          The amount charged for the first billing period recurring bill item

          <Expandable>
            <ParamField body="currency" type="string" required>
              The currency code for the first billing period recurring bill item amount (e.g., "DKK")
            </ParamField>

            <ParamField body="amount" type="number" required>
              The amount of the first billing period recurring bill item amount (e.g., 100.00)
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="dueDate" type="date" required>
          The due date in ISO 8601 format of the first billing period bill item
        </ParamField>

        <ParamField body="accountingPeriod" type="string" required>
          The accounting period for the first billing period bill item, in the format "YYYY-MM-DD/YYYY-MM-DD"
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="discount" type="object">
      Discount that is going to be applied to the recurring bill item

      <Expandable>
        <ParamField body="amount" type="object">
          The amount that is going to be subtracted from the recurring bill item amount
          Either this or "percentage" is required

          <Expandable title="object">
            <ParamField body="currency" type="string">
              The currency code for the amount subtracted from the recurring bill item amount (e.g., "DKK")
            </ParamField>

            <ParamField body="amount" type="number">
              The amount subtracted from the recurring bill item amount (e.g., 100.00)
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="percentage" type="number">
          The percentage of the recurring bill item amount that is going to be subtracted (e.g., 0.10)
          Either this or "amount" is required
        </ParamField>

        <ParamField body="description" type="string">
          The content of the discount description that is going to be put on the bill
        </ParamField>

        <ParamField body="endDate" type="date">
          The date in ISO 8601 format on which discount ends
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

### Response

<ResponseField name="recurringBillItemId" type="string">
  The unique identifier for the created recurring bill item
</ResponseField>

<ResponseField name="firstDueDate" type="date">
  The first due date in ISO 8601 format of the recurring bill item
</ResponseField>