Actions22
Overview
This node integrates with the FreshBooks API to list services associated with a specific project within a FreshBooks business. It is useful for users who want to retrieve and manage service data linked to projects, such as billing items or work categories defined in FreshBooks.
Common scenarios include:
- Fetching all services for a project to display or process them in workflows.
- Filtering services by project ID to automate invoicing or reporting.
- Limiting the number of returned services for performance or pagination control.
Example: A user wants to list all services under a particular project to generate an invoice with detailed line items.
Properties
| Name | Meaning |
|---|---|
| Business ID | Your FreshBooks Business ID. Found in your FreshBooks account URL or via the API /users/me call. |
| Project ID | The ID of the project to filter services by. |
| Return All | Whether to return all matching services or limit the results. |
| Limit | Maximum number of services to return if not returning all (default 50). |
Output
The node outputs an array of JSON objects, each representing a service retrieved from FreshBooks. Each service object contains fields as returned by the FreshBooks API under the services property, such as service name, description, rate, and other metadata related to the service.
No binary data is output by this node.
Dependencies
- Requires a valid FreshBooks API OAuth2 credential configured in n8n.
- Needs network access to
https://api.freshbooks.com. - The user must provide a valid Business ID and Project ID to query services.
Troubleshooting
- Missing or invalid Business ID: Ensure the Business ID is correct and corresponds to your FreshBooks account.
- Invalid Project ID: The Project ID must exist and be associated with the given Business ID; otherwise, no services will be returned.
- API authentication errors: Verify that the OAuth2 credentials are correctly set up and have sufficient permissions.
- Limit and pagination issues: If you expect more results than the default limit, enable "Return All" or increase the limit accordingly.
- Empty results: Confirm that the project has services assigned; otherwise, the output will be empty.