---
title: "Changes to Creates an invoice"
method: POST
path: "/invoices"
---

# Changes to Creates an invoice

`POST /invoices`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `c393d0102005`: 18 breaking, 8 warning, 19 info

## Changes

- **2026-11-03** `c393d0102005`: 18 breaking, 8 warning, 19 info
  - added `#/components/schemas/TaxRateWithOptionalAmount` to the `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate` request property `allOf` list
  - the `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate` request property type changed from `object` to no type
  - the response property `address/line2` became nullable for the status `200`
  - the response property `address/state` became nullable for the status `200`
  - the response property `address/state` became optional for the status `200`
  - the `customer_address` response's property type changed from `object` to no type for status `200`
  - the `items/items/quantity` response's property type changed from `number` to `string`, and format from no format to `number` for status `200`
  - the `shipping_address` response's property type changed from `object` to no type for status `200`
  - removed the required property `customer_address/city` from the response with the `200` status
  - removed the required property `customer_address/country` from the response with the `200` status
  - removed the required property `customer_address/line1` from the response with the `200` status
  - removed the required property `customer_address/state` from the response with the `200` status
  - removed the required property `customer_address/zip_code` from the response with the `200` status
  - removed the required property `shipping_address/city` from the response with the `200` status
  - removed the required property `shipping_address/country` from the response with the `200` status
  - removed the required property `shipping_address/line1` from the response with the `200` status
  - removed the required property `shipping_address/state` from the response with the `200` status
  - removed the required property `shipping_address/zip_code` from the response with the `200` status
  - removed the request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate/country`
  - removed the request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate/description`
  - removed the request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate/percentage`
  - removed the request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate/tax_amount`
  - removed the request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate/type`
  - removed the optional property `customer_address/line2` from the response with the `200` status
  - removed the optional property `shipping_address/line2` from the response with the `200` status
  - added the new `PROGRESS` enum value to the `items/items/revenue/pattern` response property for the response status `200`
  - added the new optional `query` request parameter `idempotency_key`
  - added the new optional `query` request parameter `replaces_request_id`
  - added the new optional request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/billing_address_id`
  - added the new optional request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/email_selection`
  - added the new optional request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/tax_rate/tax_code`
  - added the new optional request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/shipping_address_id`
  - added the new optional request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/shipping_customer_id`
  - added the new `PROGRESS` enum value to the request property `oneOf[#/components/schemas/CreateArOnlyInvoiceRequest]/items/items/revenue/pattern`
  - added the new `PROGRESS` enum value to the request property `oneOf[#/components/schemas/CreateFullInvoiceRequest]/items/items/revenue/pattern`
  - added the new `PROGRESS` enum value to the request property `oneOf[#/components/schemas/CreateRevenueRecognitionOnlyInvoiceRequest]/items/items/revenue/pattern`
  - the `oneOf[#/components/schemas/CreateArOnlyInvoiceRequest]/items/items/quantity` request property's min was decreased from `0.00` to `0.00`
  - the `oneOf[#/components/schemas/CreateRevenueRecognitionOnlyInvoiceRequest]/items/items/quantity` request property's min was decreased from `0.00` to `0.00`
  - added the non-success response with the status `409`
  - added the optional property `metadata` to the response with the `200` status
  - …5 more

---

[Operation](https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/invoices/post.md) - [API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [Page](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/invoices/post)