FreshBooks

FreshBooks Node

Actions22

- List
Client Actions
Project Actions
Service Actions
Time Tracking Actions
User Actions
- List

Overview

This node operation lists projects from a FreshBooks account filtered by specified criteria. It is useful for retrieving project data such as active projects, projects linked to specific clients, or excluding completed projects. Typical use cases include:

Fetching all active projects for certain clients to display in dashboards or reports.
Retrieving a limited number of projects for quick overviews.
Filtering out completed projects to focus on ongoing work.

For example, a user might list all active projects for client IDs "123,456" and exclude completed projects to monitor current workloads.

Properties

Name	Meaning
Business ID	Your FreshBooks Business ID, found in your account URL or via the API.
Return All	Whether to return all matching projects or limit the number of results.
Limit	Maximum number of projects to return if not returning all (minimum 1).
Client IDs	Comma-separated list of client IDs to filter projects by (required).
Active Projects Only	Whether to return only active projects (`true` or `false`).
Exclude Completed	Whether to exclude projects marked as completed (`true` or `false`).

Output

The output is an array of JSON objects representing projects. Each object corresponds to a single project with its properties as returned by the FreshBooks API. The exact fields depend on the API response but typically include project identifiers, status, client association, and other metadata.

No binary data output is produced by this operation.

Dependencies

Requires a valid FreshBooks API authentication token configured in n8n credentials.
Needs the FreshBooks Business ID to construct API requests.
Relies on the FreshBooks REST API endpoint for projects: /comments/business/{businessId}/projects.

Troubleshooting

Missing or invalid Business ID: Ensure the Business ID is correctly entered; otherwise, API calls will fail.
Empty Client IDs: This property is required; leaving it empty will cause errors or no results.
API rate limits: If many projects are requested with Return All enabled, you may hit API rate limits; consider using Limit.
No projects returned: Check that the client IDs exist and have associated projects; also verify filters like active or completed flags.
Authentication errors: Confirm that the API key or OAuth2 token is valid and has necessary permissions.