Create and Update an Invoice

Learn to create an invoice and update it using the FreshBooks API.

An invoice is a bill to the client(s) against the servicesIt is a time tracking that tells the clients how much time has been spent doing their work. and/or items we offer. It states the details of the amount that a client owes. Invoices help us maintain a record of our sales in FreshBooks.

In this lesson, we’ll see how to create an invoice and update it. We’ll also learn to upload a logo and use it on the invoice. We use the following endpoints to achieve these tasks:

  • Create an invoice: /accounting/account/{ACCOUNT_ID}/invoices/invoices
  • Update an invoice: /accounting/account/{ACCOUNT_ID}/invoices/invoices/{INVOICE_ID}

The endpoints we study for invoice-related operations require the following scope permissions:

  • user:invoices:read
  • user:invoices:write

A single invoice with line items

In this section, we’ll create an invoice with line items. This means we’ll provide details of the items in the HTTP POST request. We can use previously added items or list new items in the lines array.

Request parameters

Let’s see some important parameters in the table below:

Get hands-on with 1200+ tech skills courses.