Harvest icon

Harvest

Interact with Harvest API for time tracking and invoicing

Invoice → Update

AI-generated

Summary

Update an existing invoice in Harvest by specifying its ID and the fields to change, such as client ID, subject, notes, invoice number, taxes, discount, currency, issue date, payment options, and payment terms.

Inputs

  • ID (required) — The unique identifier of the invoice to update.
  • Update Fields — Optional fields to update on the invoice, including client ID, subject, notes, invoice number, purchase order number, tax percentages, discount percentage, currency code, issue date, and available payment options (ACH, Credit Card, PayPal).
  • Payment Term — The timeframe within which the invoice should be paid. Options include no change, 'Upon Receipt', 'Net 15', 'Net 30', 'Net 45', 'Net 60', or 'Custom'.
  • Custom Due Date (required) — The due date for the invoice in YYYY-MM-DD format, required only if the payment term is set to 'Custom'.

Output shape

a single updated invoice object in JSON format

Returns the full updated invoice object on successful update. If an error occurs, the operation throws an error. Inputs must include the invoice ID and any fields to update. The custom due date is required if the payment term is set to custom.

Examples

Example 1: Update invoice subject and set payment term to Net 30

Set ID to the invoice's ID, update client ID or other fields if desired, set subject to new value, set payment term to 'net 30', leave custom due date empty.

Discussion