Field
Type
Description
externalId
Your own id for this invoice, from your software. Send the same externalId again to update this invoice instead of adding a new one. We match on this value but do not stop duplicates, so keep it unique within the site.
invoiceNumber
The number assigned from the source system and displayed to the customer on the invoice. Two invoices on a site can share a number, and a payment applied by number goes to the first match found, so keep it unique within the site.
totals
The total amounts on the invoice. When lines are supplied, total is validated against them and must equal the sum of every lines[].total, plus taxes, minus discounts. A request whose totals do not reconcile is rejected. Omit lines and no such check is made.
customer
A reference to the customer record.
invoiceTermName
The name of an invoice term set up for the site, such as Net 30. When sent, the due date is calculated from the term and the invoice date, replacing any dueDate you send. A name that matches no term is rejected with Invoice term "" not found. When left out of a new invoice, the customer's invoice term is used if it has one.
lines
A list of line items on the invoice. Required if description is not passed in.
description
A short description of the products/services on the invoice. Required if lines are not passed in.
invoiceDate
The date of the invoice. If set in the future, the invoice is not texted or emailed to the customer until that date. Defaults to today if left blank. A date without a time. A time or time zone sent with it is dropped, not converted, so the date stays as written. Format = YYYY-MM-DD
dueDate
The date the invoice is due. Ignored when invoiceTermName is sent, because the term sets the due date. A date without a time. A time or time zone sent with it is dropped, not converted, so the date stays as written.
Default = Today (2026-11-21) Format = YYYY-MM-DD
expireAt
The date the invoice expires. On that date, an invoice with a balance and no payments is cancelled and the customer can no longer pay it. An invoice that has received any payment does not expire. A date without a time. A time or time zone sent with it is dropped, not converted, so the date stays as written. Format = YYYY-MM-DD
poNumber
The purchase order number assigned from the source system and displayed to the customer on the invoice. It does not need to be unique.
customerMemo
A note presented to the customer on the bottom of the invoice.
internalMemo
A memo added to the bottom of the invoice. Only visible to internal staff, never displayed to customers.
payments
A list of payments made on the invoice.
webhookUrl
The url to post to when certain actions are performed on the invoice. A webhook is sent when a payment reaches a new status, and when a text message, email or WhatsApp message is sent, delivered, read, delayed or fails, or the customer clicks the payment link.
options
Options to set on the invoice.
attachmentRefs
A list of attachments.
send
Who the invoice is sent to, per channel. A channel you list is used as given, and an empty list ([]) turns that channel off. A channel you omit keeps the recipients the invoice already has, or is filled from the customer's contacts, following the customer's notification control, when it has none yet. On a create, leave send out to let the customer's contacts decide every channel when the invoice is sent. On an update, leaving it out keeps the recipients already chosen. A read returns send.to as null until recipients have been chosen. billTo.emails and billTo.sms stay the override for who receives those channels, but never turn back on a channel send turned off.
onHold
Whether the first unpaid installment is held, so its payment request is not sent until the hold is released. On a read it is true when that installment is held and false otherwise. On a write, set it to true to hold that installment, or to false on an update to release it. Omit it to leave the hold as it is. The hold lives on the installment, not on the invoice.
false releases a hold you or the merchant placed. It does not release the hold an invoice gets when it reaches nobody and will not be charged automatically: send.to turns every channel off, or every address of the customer is do-not-contact and there is no billTo override. That invoice stays held and the write still succeeds, also when you supply installments yourself or set installments[].onHold to false. Give it a recipient to let it send.
A write that sends both onHold and installments[].onHold on the first unpaid installment must give them the same value. Otherwise it is refused with a 400 and the message "Invalid on_hold, it conflicts with on_hold on the first unpaid installment. Send one of them, or the same value in both". A value that is not a boolean is refused with "Invalid on_hold, must be a boolean".
deleted
This flag represents whether the record is deleted and no longer available to be used.