FreshBooks icon

FreshBooks

FreshBooks Node

Actions22

Overview

This node integrates with the FreshBooks API to retrieve detailed information about a specific time tracking entry within a FreshBooks business account. The "Get" operation under the "Time Tracking" resource fetches data for a single time entry identified by its unique ID.

Typical use cases include:

  • Fetching details of a particular time entry for review or reporting.
  • Integrating time tracking data into other workflows or dashboards.
  • Validating or auditing time entries before invoicing or payroll processing.

For example, a user might want to automatically pull the details of a time entry after it is logged in FreshBooks to update an internal project management system.

Properties

Name Meaning
Business ID Your FreshBooks Business ID. Found in your FreshBooks account URL or via the user info API endpoint.
Time Entry ID The unique identifier of the time entry you want to retrieve.

Output

The output JSON contains the full details of the requested time entry as returned by the FreshBooks API. This typically includes fields such as start time, duration, associated project or service, notes, and whether the time has been logged.

No binary data is output by this operation.

Example output structure (simplified):

{
  "time_entry": {
    "id": "string",
    "started_at": "ISO8601 datetime string",
    "duration": number,
    "note": "string",
    "is_logged": boolean,
    "project_id": "string",
    "service_id": "string",
    ...
  }
}

Dependencies

  • Requires an active FreshBooks account with valid API access.
  • Needs an API authentication token configured in n8n credentials (OAuth2 or API key).
  • The node makes HTTP GET requests to the FreshBooks API endpoint /timetracking/business/{businessId}/time_entries/{timeEntryId}.

Troubleshooting

  • Invalid Business ID or Time Entry ID: Ensure that the Business ID and Time Entry ID are correct and correspond to existing records in FreshBooks.
  • Authentication Errors: Verify that the API credentials are correctly set up and have sufficient permissions.
  • Network Issues: Check internet connectivity and FreshBooks API status.
  • API Rate Limits: If many requests are made in a short time, the API may throttle; implement retries or reduce request frequency.
  • Error Messages:
    • 404 Not Found: The specified time entry does not exist or does not belong to the given business.
    • 401 Unauthorized: Authentication failed; check API credentials.
    • 400 Bad Request: Invalid parameters; verify input values.

Links and References

Discussion