@bitovi/n8n-nodes-freshbooks

This is an n8n community node. It lets you use FreshBooks in your n8n workflows.

FreshBooks is a cloud-based accounting software designed for small businesses and freelancers, providing tools for invoicing, time tracking, expense management, and financial reporting.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

• Make sure to allow community nodes with N8N_COMMUNITY_PACKAGES_ENABLED=true
• Once logged in to your N8N web UI, go to /settings/community-nodes and type @bitovi/n8n-nodes-freshbooks

Operations

Clients

• List Clients: Retrieve all clients from your FreshBooks account

Projects

• List Projects: Get all projects for specified clients

Services

• List Services: Get available services for a specific project

Time Tracking

• List Time Entries: Retrieve time entries from your FreshBooks account
• Get Time Entry: Retrieve a specific time entry by ID
• Create Time Entry: Add a new time entry with client, project, service, note, date, and duration
• Update Time Entry: Modify an existing time entry
• Delete Time Entry: Remove a time entry

User

• Get User Info: Retrieve current user information

Credentials

This node requires OAuth2 authentication with FreshBooks.

• Client ID: Your FreshBooks OAuth2 client ID from your app registration
• Client Secret: Your FreshBooks OAuth2 client secret from your app registration
• Authorization URL: https://my.freshbooks.com/service/auth/oauth/authorize

To set up OAuth2 credentials:

1. Register your application in the FreshBooks Developer Portal
2. Configure the redirect URI in your FreshBooks app settings
3. Use the provided Client ID and Client Secret in your n8n credentials

Compatibility

• Node version: 1
• Tested with latest n8n version

Usage

This node provides comprehensive access to FreshBooks functionality for accounting and time tracking:

Time Tracking Operations

Creating Time Entries

• Client ID: Select the client for billing
• Project ID: Associate with specific project
• Service ID: Categorize the type of work performed
• Note: Detailed description of work performed
• Date: When the work was performed
• Duration: Time spent in seconds (default: 28800 = 8 hours)
• Is Logged: Whether the entry is marked as logged (default: true)

Managing Time Entries

• List all time entries with pagination support
• Get specific time entries by ID
• Update existing entries with new information
• Delete time entries when needed

Filtering and Options

Client Operations

• Filter by visibility state (active/archived)
• Sort by various criteria (updated date, created date, etc.)

Project Operations

• Filter projects by specific client IDs
• Show only active projects
• Exclude completed projects from results

Pagination Support

• Return All: Get all results or limit the number returned
• Limit: Set maximum number of results (default: 50)
• Automatic pagination handling for large datasets

User Information

• Retrieve current authenticated user details
• Access business and account information

Resources

• n8n community nodes documentation
• FreshBooks API documentation
• FreshBooks Developer Portal

Version history

• v0.1.0: Initial release
  • Client, Project, Service, Time Tracking, and User operations
  • Full CRUD support for time entries
  • OAuth2 authentication
  • Pagination support

Need help or have questions?

Need guidance on leveraging AI agents or N8N for your business? Our AI Agents workshop will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

License

MIT