Actions22
Overview
This node integrates with the FreshBooks API to manage projects within a FreshBooks business account. Specifically, the "Create" operation under the "Project" resource allows users to create new projects associated with their FreshBooks business. This is useful for automating project creation workflows, such as when onboarding new clients or starting new engagements, directly from n8n without manual entry in FreshBooks.
Practical examples include:
- Automatically creating a project in FreshBooks when a deal is won in a CRM.
- Generating projects based on form submissions or other triggers.
- Syncing project data from other systems into FreshBooks.
Properties
| Name | Meaning |
|---|---|
| Business ID | Your FreshBooks Business ID. You can find this in your FreshBooks account URL or by calling the /auth/api/v1/users/me endpoint. It identifies the business under which the project will be created. |
Note: The provided properties JSON only includes "Business ID" relevant to this resource and operation.
Output
The output of the node will be JSON data representing the newly created project object returned by the FreshBooks API. The exact structure depends on FreshBooks' API response but typically includes fields like project ID, name, status, client association, and timestamps.
No binary data output is indicated for this operation.
Dependencies
- Requires an active FreshBooks API authentication token (OAuth2) configured in n8n credentials.
- The node makes HTTP POST requests to the FreshBooks API endpoint for creating time tracking entries (though the bundled code shows time tracking endpoints, the Project resource uses a different routing path internally).
- The user must provide a valid Business ID to scope the API request correctly.
Troubleshooting
- Invalid Business ID: If the Business ID is incorrect or missing, the API call will fail. Verify the Business ID from your FreshBooks account URL or via the user info endpoint.
- Authentication errors: Ensure that the OAuth2 credential is properly set up and has the necessary permissions.
- API rate limits: FreshBooks may limit the number of API calls; if you encounter rate limit errors, consider adding delays or retries.
- Missing required fields: The node requires certain fields to create a project; ensure all mandatory inputs are provided.
Common error messages might include:
401 Unauthorized— Check API credentials.404 Not Found— Possibly wrong Business ID or endpoint.400 Bad Request— Missing or invalid input parameters.
Links and References
Note: The bundled source code primarily shows routing and operations for multiple resources including time tracking, clients, services, and projects. The "Create" operation for the Project resource is implied by the routing pattern but not explicitly detailed in the snippet. The summary focuses on the provided Resource "Project" and Operation "Create" context.