Actions22
Overview
This node operation lists time tracking entries from FreshBooks for a specified business. It is useful for retrieving logged time entries to review work done, generate reports, or integrate time data with other systems such as payroll or project management tools.
Typical use cases include:
- Fetching all time entries for a business to analyze employee or contractor hours.
- Retrieving a limited number of recent time entries for quick status updates.
- Integrating FreshBooks time tracking data into dashboards or automation workflows.
Properties
| Name | Meaning |
|---|---|
| Business ID | Your FreshBooks Business ID. Found in your FreshBooks account URL or via the user info API endpoint. |
| Return All | Whether to return all available time entries or limit the results to a specified maximum number. |
| Limit | Maximum number of time entries to return when "Return All" is false. Defaults to 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.
No binary data is output by this operation.
Dependencies
- Requires an active FreshBooks account and a valid API authentication token configured in n8n credentials.
- The node uses the FreshBooks API endpoint for time tracking:
/timetracking/business/{businessId}/time_entries. - Pagination is handled internally to fetch multiple pages if "Return All" is enabled.
Troubleshooting
- Missing or invalid Business ID: Ensure the Business ID is correctly entered; it must match the ID visible in your FreshBooks account URL or obtained via the user info endpoint.
- API authentication errors: Verify that the API key or OAuth2 credentials are properly set up and have sufficient permissions to access time tracking data.
- Limit vs Return All confusion: If you want to retrieve all time entries, enable "Return All". Otherwise, specify a reasonable "Limit" to avoid large data loads.
- Empty results: Confirm that there are time entries logged for the given Business ID and that any filters (if added later) do not exclude all entries.
Links and References
- FreshBooks API Documentation - Time Tracking
- FreshBooks Developer Portal
- n8n Documentation on HTTP Request Node (for understanding API calls)
This summary is based solely on static analysis of the provided source code and property definitions.