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

# invoice_items_create

> Add a line to an invoice. Name an existing price as `pricing.price`, or give an `amount` directly. Without `invoice` the line waits for the customer's next subscription invoice.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.stripe.com/v1/invoiceitems"}</code></div>

```python stripe_invoice_items_create.py theme={null}
from charter.packs import stripe

result = await stripe.invoice_items_create.ainvoke({"customer": ...})
```

## Body

<div className="reference-table">
  | Field                                                            | Type                                                                                        | Description                                                                                                                                                                                          |
  | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `amount`                                                         | `integer`                                                                                   | The amount in the smallest currency unit. Negative reduces what the invoice is due. Cents, not dollars: \$15.00 is 1500, and 15 puts fifteen cents on the invoice. Multiply a decimal amount by 100. |
  | `description`                                                    | `string`                                                                                    | What this line says on the invoice.                                                                                                                                                                  |
  | `quantity`                                                       | `integer`                                                                                   | How many units this line bills. <span className="field-constraints">≥ 0</span>                                                                                                                       |
  | `pricing`                                                        | [InvoiceItemPricing](/charter/charter/packs/stripe/invoiceitems/objects#invoiceitempricing)         | An existing price to bill, named as `pricing.price`.                                                                                                                                                 |
  | `priceData`                                                      | [InvoiceItemPriceData](/charter/charter/packs/stripe/invoiceitems/objects#invoiceitempricedata)     | A price created inline for this line.                                                                                                                                                                |
  | `period`                                                         | [InvoiceItemPeriod](/charter/charter/packs/stripe/invoiceitems/objects#invoiceitemperiod)           | The service period this line covers.                                                                                                                                                                 |
  | `discountable`                                                   | `boolean`                                                                                   | Whether invoice-level discounts apply to this line.                                                                                                                                                  |
  | `discounts`                                                      | [SubscriptionDiscount](/charter/charter/packs/stripe/subscriptions/objects#subscriptiondiscount)\[] | Coupons or promotion codes applying to this line alone.                                                                                                                                              |
  | `metadata`                                                       | map of `string`                                                                             | Set of key-value pairs attached to the line.                                                                                                                                                         |
  | `taxBehavior`                                                    | [PriceTaxBehavior](/charter/charter/packs/stripe/invoiceitems/objects#pricetaxbehavior)             | Whether the amount includes tax. Once set to inclusive or exclusive it cannot be changed.                                                                                                            |
  | `taxCode`                                                        | `string`                                                                                    | The tax code for what is being billed.                                                                                                                                                               |
  | `customer` <span className="required" title="required">\*</span> | `string`                                                                                    | The ID of the customer to bill.                                                                                                                                                                      |
  | `currency`                                                       | `string`                                                                                    | Three-letter lowercase ISO currency code.                                                                                                                                                            |
  | `invoice`                                                        | `string`                                                                                    | The draft invoice to add this line to, at most 250 lines. Absent, the line waits for the customer's next subscription invoice and a standalone invoice will not collect it on its own.               |
  | `subscription`                                                   | `string`                                                                                    | Bill this line on that subscription's invoices only.                                                                                                                                                 |
</div>