Skip to main content

CreateInvoice creates a manual invoice.

POST 
/api/v1/billing/invoices

Creates a new invoice with custom line items. Use this for one-off charges, professional services, or adjustments not covered by automatic billing.

Authorization​

Requires billing:admin permission.

Behavior​

  • Invoice is created in 'open' status
  • Invoice number is auto-generated
  • Tax is calculated based on organization's tax rate
  • Email notification sent to billing contact

Response​

Returns created Invoice with calculated totals.

Errors​

  • PERMISSION_DENIED: Caller lacks billing:admin permission
  • INVALID_ARGUMENT: Missing required fields or invalid items
  • NOT_FOUND: Organization does not exist

Request​

Responses​

A successful response.