Skip to main content
POST
Create an issued invoice

Query Parameters

orgId
string
required

Organization ID. Use GET /v1/companies to discover available org/company pairs.

Example:

"1"

companyId
string
required

Company ID. Use GET /v1/companies to discover available companies and their access levels.

Example:

"1"

Body

application/json
customer
object
required
currency
string
required

ISO 4217 code the document is priced in, e.g. "CHF".

Required string length: 1 - 10
lines
object[]
required
Required array length: 1 - 200 elements
invoiceNumber
string
default:""

Free text, required to send (book) the invoice. Read latestNumber from GET /sales-invoices to continue a sequence.

Maximum string length: 100
seller
object

The issuing company block printed on the document. Missing fields default to empty strings.

issueDate
string
default:""

Calendar day yyyy-MM-dd (UTC); "" = unset. An invalid day 400s.

Maximum string length: 10
dueDate
string
default:""

Calendar day yyyy-MM-dd (UTC); "" = unset. An invalid day 400s.

Maximum string length: 10
vatInclusive
boolean
default:false

True when unit prices already include VAT (the tax is carved out); false adds VAT on top.

discount
object | null

Whole-invoice discount applied before VAT, pro-rata across VAT groups. Null = none.

status
enum<string>
default:draft
Available options:
draft,
sent,
paid,
cancelled
accentId
string
default:ink

Document accent color id (one of the builder's six).

Maximum string length: 20
notes
string
default:""
Maximum string length: 4000
logoDataUrl
string | null
Maximum string length: 400000

Response

Invoice saved

success
enum<boolean>
required
Available options:
true
data
object
required
Last modified on November 13, 2026