@bitovi/n8n-nodes-freshbooks
v0.1.1
Published
N8N node to connect to FreshBooks
Maintainers
Keywords
Readme
@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-nodesand 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:
- Register your application in the FreshBooks Developer Portal
- Configure the redirect URI in your FreshBooks app settings
- 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
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.
