Create invoice line item

Endpoint for creating a new invoice line item.

Path Params
string
required
Query Params
string

Comma-separated related objects to return in full instead of as IDs. Accepted values: account, account.parent, item, tax_rate, cost_center. Nested relations are joined with a dot.

Body Params

A line item of an invoice.

string
required

The account associated with this line item.

string

The cost center associated with this line item.

custom_fields
object

A mapping of custom field IDs to their values.

string
required

The detailed description of the line item.

double | null
≥ 0

The discount as the percentage.

string

The item associated with this line item.

string | null

The item unit of measure for this line item.

integer

The position of the line item within the document.

double
required

The quantity of the item or service.

revenue_recognition

Optional revenue recognition configuration. When provided, a revenue recognition is created for this line item.

string | null

The tax exemption reason of the line, as reporting to the tax authority needs it on a zero-rated or exempt line: a code the tax rate of the line offers (the TaxExemptionReasonCodes page lists them), or, on the KSA out-of-scope rate, the reason written out. On a rate that takes no reason, a reason sent is kept but not reported. null or "" clears the reason. Left out, a new line takes the default of its item, else the default of the contact (when the line is on the default revenue tax rate of the contact), else the default of its tax rate, else none. So does a line whose tax rate or item changes. Any other line keeps its reason, also when an update sends the lines again: each line is compared with the stored line at the same position.

string

The tax rate applied to this line item: the ID of the tax rate (tax_…). List the tax rates of the organization with GET /v1/tax-rates/. Add expand=line_items.tax_rate to get the full tax rate in the response.

double
required

The price per unit of the item or service.

Headers
string

Client-provided UUID to uniquely identify a request

string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json