Create a draft invoice
billy_create_draft_invoiceDestructive
WRITE: create ONE invoice in the DRAFT state for an existing contact. The invoice is NOT approved, booked, numbered into the ledger or sent: the user reviews it in Billy and approves and sends it there. The invoice number is assigned by Billy. No payment is created. Not idempotent: a repeat call creates a second draft. POST /invoices with state=draft.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lines | Yes | 1-100 invoice lines. | |
| tax_mode | No | Whether unit prices include (incl) or exclude (excl) VAT (default: the company's setting). | |
| contact_id | Yes | The customer's contact id (from billy_list_contacts or billy_create_contact). | |
| entry_date | No | Invoice date yyyy-mm-dd (default today, UTC). | |
| currency_id | No | Invoice currency, e.g. DKK (default: the company's base currency). | |
| contact_message | No | Message to the customer shown at the top of the invoice PDF. |