FreshBooks icon

FreshBooks

FreshBooks Node

Actions22

Overview

This node integrates with the FreshBooks API to list user information. Specifically, when using the "User" resource with the "List" operation, it retrieves a list of users associated with the authenticated account. This is useful for scenarios where you want to fetch and process user data from FreshBooks, such as generating reports, syncing user lists with other systems, or managing user-related workflows.

For example, you might use this node to:

  • Retrieve all users in your FreshBooks account to display them in a dashboard.
  • Limit the number of users fetched for performance reasons.
  • Automate user management tasks by processing the list programmatically.

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 (default 50).

Output

The output consists of an array of JSON objects, each representing a user retrieved from FreshBooks. Each item contains user details as returned by the FreshBooks API under the json property.

The structure of each user object typically includes fields like user ID, name, email, and other relevant user metadata provided by FreshBooks.

This node does not output binary data.

Dependencies

  • Requires an API authentication token configured via OAuth2 credentials for FreshBooks.
  • The node uses the FreshBooks API endpoint /auth/api/v1/users/me to fetch user information.
  • No additional external dependencies are required beyond the FreshBooks API access.

Troubleshooting

  • Empty Results: If no users are returned, verify that the API credentials have sufficient permissions and that the account actually has users.
  • API Authentication Errors: Common errors include invalid or expired tokens. Re-authenticate the API credentials in n8n.
  • Limit Exceeded: Setting a very high limit without enabling "Return All" may cause incomplete data retrieval. Use "Return All" to paginate through all results.
  • Network Issues: Ensure that the n8n instance can reach the FreshBooks API endpoint (https://api.freshbooks.com).

Links and References

Discussion