Actions22
Overview
This node integration with FreshBooks allows users to list time tracking entries associated with a specific business. It is useful for retrieving logged work hours or time entries for projects, services, or clients within a FreshBooks account. Typical use cases include generating reports on billable hours, auditing time spent on tasks, or syncing time tracking data with other systems.
For example, a project manager could use this node to fetch all time entries for their business to analyze team productivity or invoice clients based on tracked time.
Properties
| Name | Meaning |
|---|---|
| Business ID | Your FreshBooks Business ID. This identifies the business whose time entries you want to list. You can find it in your FreshBooks account URL or by calling the user info endpoint. Example: "12345". |
| Return All | Boolean option to specify whether to return all available time entries or limit the number of results. |
| Limit | When not returning all, this sets the maximum number of time entries to retrieve (minimum 1). Default is 50. |
Output
The output consists of an array of JSON objects, each representing a time entry retrieved from FreshBooks. Each item contains the raw time entry data as returned by the FreshBooks API under the json field.
The structure of each time entry typically includes fields such as start time, duration, notes, and related project or service IDs, although exact fields depend on FreshBooks API responses.
This node does not output binary data.
Dependencies
- Requires a valid FreshBooks API authentication token configured in n8n credentials.
- The node makes HTTP GET requests to the FreshBooks API endpoint
/timetracking/business/{businessId}/time_entries. - Pagination is handled internally to support fetching all entries if requested.
Troubleshooting
- Invalid Business ID: If the Business ID is incorrect or missing, the API will fail to return time entries. Verify the Business ID from your FreshBooks account URL or user info endpoint.
- API Authentication Errors: Ensure that the API key or OAuth2 token used in credentials is valid and has permissions to access time tracking data.
- Rate Limits: Fetching large numbers of entries may hit API rate limits; consider using the "Return All" option judiciously or limiting the number of results.
- Empty Results: If no time entries are returned, confirm that there are existing time entries for the specified business in FreshBooks.