Skip to main content
POST
Create Bills

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-user-id
string | null

Optional external entity identifier that performed the action

Path Parameters

business_id
string<biz_string>
required

The id of the business

Example:

"biz_GA6EG2qFxA97NZHtxeLPUy"

Body

application/json
Maximum array length: 100
business_id
string<biz_string>
required

The ID of the Business that the bill is associated with

Example:

"biz_Pk2fNFDd8wj7EFeLWJywc7"

number
string
required

The number of the bill

Example:

"BILL-001"

description
string
required

The description of the bill

Example:

"Office supplies"

due_at
string<date-time>
required

The due date of the bill in ISO-8601 format

Example:

"2025-02-15T00:00:00Z"

issued_at
string<date-time>
required

The date the bill was issued in ISO-8601 format

Example:

"2025-01-15T00:00:00Z"

vendor_id
string<ven_string>
required

The ID of the Vendor that the bill is associated with

Example:

"ven_WQMDNUHpBThYSNh4AprDBo"

lines
BillLineCreate · object[]
required

The lines of the bill

tags
Tags · object | null

Inline tag input. Each field maps to either a single value (string, e.g. 'NYC') or a list of {value, amount} objects to allocate the bill across multiple values. The tag field must already exist; values are created automatically if missing. Per-field sum of amounts must not exceed the bill total.

Example:

Response

Successful Response

data
BillPublic · object[]
required
errors
BillCreateError · object[]
required