Invoices

Create an invoice draft

Changed on Oct 1, 2026

Creates an invoice draft with sensible defaults and generated line item IDs. You can include client details inline.

post/invoices/create

Request

Base URL
https://api.vocal.email/v1
Auth
- API key in header X-API-Key
- or HTTP bearer
TypeScript
https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api/docs/invoices/create/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

clientIdstring

Existing client id.

confirmDateboolean

Request-only, never stored: confirms an invoice date outside the current year.

Response

Invoice created

dataunknown

successtrue required

Example response

{
  "data": {},
  "success": true
}

Changes

Oct 1, 2026d0319ad57804 Revision changes
- breaking
  added the new required request property /
- breaking
  the request property became required
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /

Operation history