Skip to main content
POST
Create a custom invoice
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /billing/invoices/custom Creates a manually-issued TenantInvoice (invoiceType: custom) — used for one-off charges outside the Stripe subscription flow. Authorization:
  • Required role: owner only

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
totalAmount
number
required
Required range: x >= 0.01
description
string
required
taxAmount
number
discountAmount
number
currency
string
Example:

"USD"

dueDate
string<date-time>
lineItems
object[]
notes
string
paymentMethod
string
referenceNumber
string

Response

Custom invoice created

status
string
Example:

"success"

message
string
data
object

Locally-stored invoice row (TenantInvoice model) — custom/manual invoices only; Stripe-hosted invoices are fetched live and merged in GET /billing/invoices.