Actions22
Overview
This node operation allows you to create a new time tracking entry in FreshBooks. It is useful for automating the logging of work hours associated with specific clients, projects, and services within your FreshBooks account. Typical use cases include recording billable hours, tracking employee or contractor time, and integrating time tracking data into broader workflows such as invoicing or project management.
For example, you can use this node to automatically add a time entry when a task is completed in a project management tool, ensuring accurate billing and time records without manual input.
Properties
| Name | Meaning |
|---|---|
| Business ID | Your FreshBooks Business ID. Found in your FreshBooks account URL or via user info API endpoint. |
| Client ID | The identifier of the client associated with this time entry. |
| Project ID | The identifier of the project related to this time entry. |
| Service ID | The identifier of the service performed during this time entry. |
| Note | A descriptive note or comment about this time entry. |
| Date | The date when the time entry started (only the date part is used). |
| Duration | The length of time spent on this entry, in seconds. |
| Is Logged | Boolean flag indicating whether this time entry is marked as logged. |
Output
The output JSON contains the created time entry details as returned by the FreshBooks API. This typically includes identifiers, timestamps, and all properties sent in the request, confirming successful creation.
No binary data output is produced by this operation.
Dependencies
- Requires an active FreshBooks account.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The node communicates with the FreshBooks API endpoint at
https://api.freshbooks.com.
Troubleshooting
- Invalid Business ID: Ensure the Business ID matches the one from your FreshBooks account URL or user info endpoint.
- Missing Required Fields: All required fields (Client ID, Project ID, Service ID, Note, Date, Duration) must be provided; otherwise, the API will reject the request.
- Authentication Errors: Verify that the API key or OAuth2 credentials are correctly set up and have sufficient permissions.
- Date Format Issues: The date must be in
yyyy-MM-ddformat; incorrect formatting may cause errors. - Duration Units: Duration is expected in seconds; providing other units without conversion will lead to inaccurate entries.