Skip to main content
POST
Create and send an invoice

Authorizations

Authorization
string
header
required

API key for /api/v1/* endpoints

Body

application/json
customer
object
required
line_items
object[]
required
currency
string

ISO currency code

Example:

"USD"

tax_rate
number

Tax rate as a percentage (e.g. 7.5)

Example:

7.5

discount_amount
number

Flat discount amount

Example:

50

due_date
string

Due date (ISO 8601)

Example:

"2026-07-01T00:00:00Z"

notes
string
Example:

"Thank you for your business."

metadata
object
Example:

Response

Invoice created successfully.

id
string
required
business_id
string
required
mode
object
required
customer_id
string | null
required
invoice_number
string
required
status
enum<string>
required
Available options:
draft,
sent,
viewed,
paid,
overdue,
cancelled,
void
currency
string
required
line_items
object[]
required
subtotal
number
required
tax_rate
number
required
tax_amount
number
required
discount_amount
number
required
total
number
required
due_date
string<date-time> | null
required
paid_at
string<date-time> | null
required
notes
string | null
required
provider_invoice_reference
string | null
required
cc_invoice_url
string | null
required
metadata
object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
business
object
required
customer
object
required