Resolve the authenticated FreshBooks user and their identifiers: accountId (alphanumeric, used by accounting and payments endpoints), businessId (integer, used by projects and time tracking) and businessUuid. The three are not interchangeable — using the wrong one returns a 404 rather than a useful error.

List invoices for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single invoice by its numeric FreshBooks id.

List clients for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single client by its numeric FreshBooks id.

List estimates for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single estimate by its numeric FreshBooks id.

List payments for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single payment by its numeric FreshBooks id.

List items for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single item by its numeric FreshBooks id.

Create a client (customer) in FreshBooks. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

Create an invoice for a client. Created invoices start as drafts. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

Update an existing invoice. Only the supplied fields are sent. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call. Note that changing an invoice out of draft can email it to the client.

Record a payment against an invoice. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

List expenses for the account, newest-first by default. Supports pagination and raw FreshBooks filters (e.g. {"search[categoryid]": 5}). If the response reports a total with no rows, the count includes records this identity cannot read — that is reported in the note field rather than looking like an empty account.

Get a single expense by its numeric id.

List expense categories, which supply the categoryid used when creating an expense.

Record an expense. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

List projects for the business. Uses businessId (not accountId) and works even when the business has no accounting account.

Get a single project by its numeric id.

Create a project. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

List tracked time entries for the business. The response envelope also carries total_logged and total_unbilled alongside the rows.

Log a time entry. Duration is in SECONDS. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

List services (the billable work types available to projects and time entries).

List any FreshBooks accounting resource by name — the generic reader covering the long tail (taxes, credit notes, invoice profiles, tasks, staff, gateways, bills, bill vendors, bill payments, other income, expense categories) alongside the ones with dedicated tools. Returns items plus page/pages/total. Some resources are gated by plan or account role and will report that rather than returning rows.

Get a single record from any FreshBooks accounting resource by name and id. Ids are numeric on every resource mapped here; the schema also accepts a string so an id carried around as text still works.