FreshBooks icon

FreshBooks

FreshBooks Node

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 fetches a paginated list of items from FreshBooks according to user-defined limits or returns all available results.

Common scenarios where this node is useful include:

  • Retrieving a list of time entries for reporting or analysis.
  • Fetching client or project lists to synchronize with other systems.
  • Automating workflows that require up-to-date FreshBooks data.

For example, a user might use this node to pull all time tracking entries for a business within a certain period or to get a limited number of active projects for quick display in a dashboard.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit. Options: true or false.
Limit Max number of results to return when "Return All" is false. Must be at least 1.
  • Return All: If set to true, the node will paginate through all available results from FreshBooks.
  • Limit: When "Return All" is false, this limits the number of results returned by the node.

Output

The output is an array of JSON objects representing the listed FreshBooks entities. Each item corresponds to one resource entry (e.g., a client, project, service, or time entry) returned by the API.

  • The json field contains the raw data object for each resource item.
  • The structure of each JSON object depends on the resource type but generally includes all fields returned by the FreshBooks API for that resource.
  • The node does not output binary data.

Example output snippet (simplified):

[
  {
    "json": {
      "id": "123",
      "name": "Sample Client",
      "email": "client@example.com",
      ...
    }
  },
  {
    "json": {
      "id": "124",
      "name": "Another Client",
      "email": "another@example.com",
      ...
    }
  }
]

Dependencies

  • Requires a valid FreshBooks API authentication token configured in n8n credentials.
  • The node uses the FreshBooks REST API endpoints.
  • Requires the user to provide either a Business ID or Account ID depending on the resource being accessed.

Troubleshooting

  • Common issues:

    • Incorrect or missing Business ID or Account ID will cause API requests to fail.
    • Insufficient permissions or expired API tokens will result in authentication errors.
    • Setting "Return All" to true on very large datasets may lead to long execution times or rate limiting by the API.

  • Common error messages:

    • Authentication errors: Check that the API key or OAuth token is valid and has not expired.
    • 404 Not Found: Verify that the Business ID or Account ID is correct and that the resource exists.
    • Rate limit exceeded: Reduce request frequency or limit the number of results per request.

Links and References

Discussion