SECRET_ID

SECRET_KEY

ACCESS_TOKEN

ITEM_ID

INVOICE_ID

ACCOUNT_ID

CLIENT_ID

CONTACT_ID

INVOICE_NUMBER

PAYMENT_ID

EXPENSE_ID

CODE

ITEM_TO_DELETE

IMAGE_URL

REFRESH_TOKEN

EXPIRY

Gain insights into FreshBooks API, managing clients, invoices, payments, and expenses programmatically. Learn about API endpoints, access keys, and integrate FreshBooks API in a React application.

Bookkeeping with FreshBooks API in JavaScript.png

freshbooksAuthandApp.tar.gz

authentication

demo-app

FreshBooks is a resource management software that provides several accounting services like invoicing and expenses, time tracking, inventory, and client management. FreshBooks also provides an API to manage this data programmatically.

In this course, you'll learn about FreshBooks API and its different endpoints. This course is a step-by-step guide to signing up for an account and retrieving access keys. You'll get hands-on experience in performing various tasks using the API. These include managing clients, invoices, payment records, expenses, and others. You'll also learn how to integrate FreshBooks API in a functioning React application. 

By the end of this course, you'll be equipped with the skills needed to develop applications and integrations using FreshBooks API.

Bookkeeping with FreshBooks API in JavaScript

In this lesson, we'll list the default expense categories given by FreshBooks. Next, we'll create our expenses. FreshBooks offers the facility to record the expenses that are incurred by your business.

The following two endpoints are discussed in this lesson:

- List expense categories: `/accounting/account/{ACCOUNT_ID}/expenses/categories`
- Create an expense: `/accounting/account/{ACCOUNT_ID}/expenses/expenses`

The endpoints of the expenses require the `user:expenses:read` and `user:expenses:write` scope permissions to perform the job.


# List expense categories
FreshBooks offers some default categories and sub-categories for grouping expenses, so tracking them becomes easier.

This section explains how we can get a list of all the default categories available for expenses. We use the `/accounting/account/{ACCOUNT_ID}/expenses/categories` endpoint to get a list of expense categories.

## Request parameters
This endpoint does not take any request parameters. However, we can add query parameters using `include[]`. The syntax to use include is as follows:
```
/expenses/categories?include[]=<VALUE>
```
We have two values that can be passed as a query parameter to `include`. These are as follows:
- `expense_usage_all_time`: This parameter adds the expense usage in the category for all time.
- `expense_usage_this_year`: This parameter includes the expense usage in the category for the current year.
> **Note:** Please use the "[Regenerate the Access Token"](https://www.educative.io/courses/bookkeeping-with-freshbooks-api-in-javascript/regenerate-the-access-token) lesson in the appendix to regenerate the access token.

Learn the expense categories and how to create an expense using the FreshBooks API.

List Expense Categories and Create an Expense

Introduction

Clients

Invoices

Expenses

APIs Integration in React

Conclusion

Appendix

List Expense Categories and Create an Expense