Actions22
Overview
This node integrates with the FreshBooks API to list various resources such as clients, projects, services, and time tracking entries. Specifically, for the "Default" resource with the "List" operation, it retrieves a collection of items from FreshBooks, supporting pagination and limiting the number of results returned.
Common scenarios where this node is useful include:
- Fetching all or a subset of time tracking entries for reporting or analysis.
- Retrieving lists of clients, projects, or services to synchronize with other systems.
- Automating workflows that require up-to-date FreshBooks data without manual export.
For example, you might use this node to pull the latest 50 time entries for a business to generate timesheet reports or to get all active projects associated with certain clients.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all available results (true) or limit the output to a specified number (false). |
| Limit | The maximum number of results to return when "Return All" is false. Default is 50. |
Output
The node outputs an array of JSON objects, each representing an item from the requested FreshBooks resource list. The structure of each JSON object depends on the resource type but generally includes the fields returned by the FreshBooks API for that resource.
If binary data were supported, it would be summarized here; however, this node only outputs JSON data representing FreshBooks entities.
Dependencies
- Requires an API authentication token configured in n8n credentials to access the FreshBooks API.
- Needs the FreshBooks Business ID or Account ID depending on the resource being accessed.
- The node uses the FreshBooks REST API endpoint
https://api.freshbooks.com.
Troubleshooting
Issue: No results returned despite existing data.
- Cause: Possibly incorrect Business ID or Account ID, or filters applied that exclude all records.
- Resolution: Verify the Business/Account ID values and adjust filters or parameters accordingly.
Issue: API authentication errors.
- Cause: Invalid or expired API key/token.
- Resolution: Re-authenticate the FreshBooks credential in n8n.
Issue: Exceeding rate limits or incomplete pagination.
- Cause: Large datasets with pagination not handled properly.
- Resolution: Use the "Return All" option to enable automatic pagination or increase the "Limit" carefully.
Error Messages:
- Authentication failures typically indicate invalid credentials.
- HTTP 4xx or 5xx errors suggest issues with request parameters or server availability.