FreshBooks icon

FreshBooks

FreshBooks Node

Actions22

Overview

This node operation updates an existing time tracking entry in FreshBooks. It allows users to modify details such as the client, project, service, note, date, duration, and logged status of a specific time entry identified by its ID. This is useful for correcting or refining time logs after they have been initially created, ensuring accurate billing and record-keeping.

Practical examples include:

  • Adjusting the duration or date of a previously recorded work session.
  • Changing the associated project or service if the initial entry was assigned incorrectly.
  • Adding or updating notes to provide more context about the time entry.

Properties

Name Meaning
Business ID Your FreshBooks Business ID. Found in your account URL or via user info API endpoint.
Time Entry ID The unique identifier of the time entry you want to update.
Client ID The client associated with this time entry.
Project ID The project associated with this time entry.
Service ID The service associated with this time entry.
Note A descriptive note for this time entry.
Date The start date of the time entry (only date part is used).
Duration The length of time for this entry, in seconds.
Is Logged Boolean indicating whether this time entry is marked as logged (true/false).

Output

The node outputs JSON data representing the updated time entry object returned by the FreshBooks API. This typically includes all properties of the time entry such as IDs, timestamps, notes, duration, and status flags.

No binary data output is involved in this operation.

Dependencies

  • Requires an active FreshBooks account with appropriate permissions.
  • 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 Time Entry ID: If the provided time entry ID does not exist or is incorrect, the API will return an error. Verify the ID before updating.
  • Missing Required Fields: All required fields (Business ID, Time Entry ID, Client ID, Project ID, Service ID, Note, Date, Duration) must be provided; otherwise, the request will fail.
  • Authentication Errors: Ensure that the API key or OAuth2 token is valid and has not expired.
  • Date Format Issues: The date must be in yyyy-MM-dd format; incorrect formatting may cause errors.
  • Permission Denied: The authenticated user must have rights to update time entries in the specified business.

Links and References

Discussion