FreshBooks

Validate the OAuth credentials and return information about the authenticated user.

List all clients. Supports pagination and filtering by email or organization.

Get a specific client by ID with full details including contact info and outstanding balance.

Create a new client. Provide at least an email or organization name.

Update a client’s information. Only provided fields will be updated.

Delete a client by setting their visibility state to deleted.

List all expenses. Supports pagination and filtering by category or client.

Get a specific expense by ID with full details including category and tax info.

Create a new expense. Requires categoryid, amount, date, and staffid.

Update an expense. Only provided fields will be updated.

Delete an expense by setting its visibility state to deleted.

List all invoices. Supports pagination and filtering by status or client ID.

Get a specific invoice by ID with full details including line items and payment status.

Create a new invoice. Requires customerid, create_date, and at least one line item.

Update an invoice. Only provided fields will be updated.

Delete an invoice by setting its visibility state to deleted.

Send an invoice by email to specified recipients.

Mark an invoice as sent without actually sending an email.

List all billable items/services. Supports pagination.

Get a specific billable item by ID with full details.

Create a new billable item/service. Requires name and unit_cost.

Update a billable item. Only provided fields will be updated.

Delete a billable item by setting its visibility state to deleted.

List all payments. Supports pagination and filtering by invoice or client.

Get a specific payment by ID with full details.

Create a new payment. Requires invoiceid, amount, and date.

Update a payment. Only provided fields will be updated.

Delete a payment by setting its visibility state to deleted.

List all projects. Requires business_id. Supports pagination and filtering by active status.

Get a specific project by ID with full details. Requires business_id.

Create a new project. Requires business_id and title.

Update a project. Requires business_id. Only provided fields will be updated.

Delete a project. Requires business_id.

List all time entries. Requires business_id. Supports pagination and filtering by project or date range.

Get a specific time entry by ID with full details. Requires business_id.

Create a new time entry. Requires business_id and started_at. Either duration or a running timer is required.

Update a time entry. Requires business_id. Only provided fields will be updated.

Delete a time entry. Requires business_id.