Create bill

Create a new bill for a vendor.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Overview

Create a new bill for a vendor. Requires at least one line item with description, quantity, and unit_price. The bill is created in Draft status.

Example: Record a $5,000 expense from a content provider by creating a bill with two line items: consulting services and software license.

Constraints

  • vendor_id must reference a valid vendor on the site
  • At least one line item is required
  • period_end must be on or after period_start
  • purchase_order max 20 characters
  • footer max 1000 characters
  • Line item quantity must be > 0
  • Line item unit_price must be >= 0
Query Params
int32
required

The unique identifier of the site associated with your account.

Body Params
integer
required

The vendor (user) ID. Must exist on the site and account.

string
required
length between 3 and 3

Three-letter ISO currency code (e.g. usd, cad).

line_items
array of objects
required
length ≥ 1

At least one line item is required.

line_items*
string
required
length ≤ 255

Line item description.

number
required
≥ 0.01

Quantity. Must be greater than 0.

number
required
≥ 0

Price per unit. Must be >= 0.

date
required

Billing period start date (YYYY-MM-DD).

date
required

Billing period end date (YYYY-MM-DD). Must be >= period_start.

string
length ≤ 1000

Bill footer text.

string
length ≤ 20

Purchase order number (max 20 chars).

metadata
object

Custom key-value metadata.

Headers
string
required
Defaults to Bearer eyJ***
Responses

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