{"_id":"@bitovi/n8n-nodes-freshbooks","_rev":"4-939e0f509c71c5fd05d74a35859f2908","name":"@bitovi/n8n-nodes-freshbooks","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@bitovi/n8n-nodes-freshbooks","version":"0.1.0","keywords":["n8n-community-node-package"],"author":{"name":"Roye","email":"roye@bitovi.com"},"license":"MIT","_id":"@bitovi/n8n-nodes-freshbooks@0.1.0","maintainers":[{"name":"justinbmeyer","email":"justin@bitovi.com"},{"name":"cherif_b","email":"cherif.bouchelaghem@gmail.com"},{"name":"alishouman","email":"alyshouman@gmail.com"},{"name":"bitovi-os","email":"os@bitovi.com"},{"name":"kyle-n","email":"kylebnazario@gmail.com"},{"name":"mhaynie_bitovi","email":"mhaynie@bitovi.com"},{"name":"bmomberger-bitovi","email":"brad@bitovi.com"},{"name":"fabioemoutinho","email":"fabioemoutinho@gmail.com"},{"name":"rlmcneary2","email":"rich@limnous.com"},{"name":"tehfedaykin","email":"jennifer.wadella@gmail.com"},{"name":"phillipskevin","email":"kphillips86@gmail.com"},{"name":"mickmcgrath13","email":"mick.mc.13@gmail.com"},{"name":"bitovi-core-os","email":"core@donejs.com"},{"name":"janebitovi","email":"jane@bitovi.com"}],"homepage":"https://github.com/bitovi/n8n-nodes-freshbooks#readme","bugs":{"url":"https://github.com/bitovi/n8n-nodes-freshbooks/issues"},"n8n":{"nodes":["dist/nodes/FreshBooks/FreshBooks.node.js"],"credentials":["dist/credentials/FreshBooksCredentialsApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"43e138143c561dfee2f1486458ab9270039ca7de","tarball":"https://registry.npmjs.org/@bitovi/n8n-nodes-freshbooks/-/n8n-nodes-freshbooks-0.1.0.tgz","fileCount":15,"integrity":"sha512-+X23h8ueYJ4UDRXr98jcoHfd/C/QWhJekafXslj3OmiEZFq0H4dkqYFhHkWFJkzLkp839Dw0BvmMIhPVABRpBg==","signatures":[{"sig":"MEUCIQCJ9BSfkI9aL+WY7Fqb52AVhtsSTnG4eLAJaZb2dvlGZgIgAfrjhKag7j0nrZtLFi/nQI2ZFb1HJc7kF8QaTvIMNfs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":101170},"main":"index.js","_from":"file:bitovi-n8n-nodes-freshbooks-0.1.0.tgz","engines":{"node":">=18.10","pnpm":">=9.1"},"scripts":{"dev":"tsc --watch","lint":"eslint nodes credentials package.json","build":"tsc && gulp build:icons","format":"prettier nodes credentials --write","lintfix":"eslint nodes credentials package.json --fix","preinstall":"npx only-allow pnpm"},"_npmUser":{"name":"bitovi-os","email":"os@bitovi.com"},"_resolved":"/private/var/folders/gy/qqwcf4492fq_yx2666wsrcy40000gn/T/14ac6d55936d034ba01f3bf8239bb735/bitovi-n8n-nodes-freshbooks-0.1.0.tgz","_integrity":"sha512-+X23h8ueYJ4UDRXr98jcoHfd/C/QWhJekafXslj3OmiEZFq0H4dkqYFhHkWFJkzLkp839Dw0BvmMIhPVABRpBg==","repository":{"url":"git+https://github.com/bitovi/n8n-nodes-freshbooks.git","type":"git"},"_npmVersion":"10.9.2","description":"N8N node to connect to FreshBooks","directories":{},"_nodeVersion":"22.17.1","_hasShrinkwrap":false,"devDependencies":{"gulp":"^4.0.2","eslint":"^8.56.0","prettier":"^3.3.2","typescript":"^5.5.3","n8n-workflow":"*","@typescript-eslint/parser":"^7.15.0","eslint-plugin-n8n-nodes-base":"^1.16.1"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-freshbooks_0.1.0_1755368172149_0.5653030162850108","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bitovi/n8n-nodes-freshbooks","version":"0.1.1","keywords":["n8n-community-node-package"],"author":{"name":"Roye","email":"roye@bitovi.com"},"license":"MIT","_id":"@bitovi/n8n-nodes-freshbooks@0.1.1","maintainers":[{"name":"justinbmeyer","email":"justin@bitovi.com"},{"name":"cherif_b","email":"cherif.bouchelaghem@gmail.com"},{"name":"alishouman","email":"alyshouman@gmail.com"},{"name":"bitovi-os","email":"os@bitovi.com"},{"name":"kyle-n","email":"kylebnazario@gmail.com"},{"name":"mhaynie_bitovi","email":"mhaynie@bitovi.com"},{"name":"bmomberger-bitovi","email":"brad@bitovi.com"},{"name":"fabioemoutinho","email":"fabioemoutinho@gmail.com"},{"name":"rlmcneary2","email":"rich@limnous.com"},{"name":"tehfedaykin","email":"jennifer.wadella@gmail.com"},{"name":"phillipskevin","email":"kphillips86@gmail.com"},{"name":"mickmcgrath13","email":"mick.mc.13@gmail.com"},{"name":"bitovi-core-os","email":"core@donejs.com"},{"name":"janebitovi","email":"jane@bitovi.com"}],"homepage":"https://github.com/bitovi/n8n-nodes-freshbooks#readme","bugs":{"url":"https://github.com/bitovi/n8n-nodes-freshbooks/issues"},"n8n":{"nodes":["dist/nodes/FreshBooks/FreshBooks.node.js"],"credentials":["dist/credentials/FreshBooksOAuth2Api.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"bae7840e9345f6b25a5ae67c493d743ec9f73717","tarball":"https://registry.npmjs.org/@bitovi/n8n-nodes-freshbooks/-/n8n-nodes-freshbooks-0.1.1.tgz","fileCount":15,"integrity":"sha512-wSaoqnR+4nxN274V51tY4wITPk5OIllaT1g/zk11SYCrFpXQjaSoQkxfn4jwqMQGNKEG9/MBP9VvHdC1BEcO5A==","signatures":[{"sig":"MEYCIQCw+ALt5+XMADqzcOHWbKzIJsE+dCX5pF4R111ZQC43fgIhAO2FZ84EPhjRAo0EZ97pMZbSUnTa8pKzk1IJe2kv9T6T","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":101160},"main":"index.js","_from":"file:bitovi-n8n-nodes-freshbooks-0.1.1.tgz","engines":{"node":">=18.10","pnpm":">=9.1"},"scripts":{"dev":"tsc --watch","lint":"eslint nodes credentials package.json","build":"tsc && gulp build:icons","format":"prettier nodes credentials --write","lintfix":"eslint nodes credentials package.json --fix","preinstall":"npx only-allow pnpm"},"_npmUser":{"name":"bitovi-os","email":"os@bitovi.com"},"_resolved":"/private/var/folders/gy/qqwcf4492fq_yx2666wsrcy40000gn/T/19c001c377e76e6725421549790cdb21/bitovi-n8n-nodes-freshbooks-0.1.1.tgz","_integrity":"sha512-wSaoqnR+4nxN274V51tY4wITPk5OIllaT1g/zk11SYCrFpXQjaSoQkxfn4jwqMQGNKEG9/MBP9VvHdC1BEcO5A==","repository":{"url":"git+https://github.com/bitovi/n8n-nodes-freshbooks.git","type":"git"},"_npmVersion":"10.9.2","description":"N8N node to connect to FreshBooks","directories":{},"_nodeVersion":"22.17.1","_hasShrinkwrap":false,"devDependencies":{"gulp":"^4.0.2","eslint":"^8.56.0","prettier":"^3.3.2","typescript":"^5.5.3","n8n-workflow":"*","@typescript-eslint/parser":"^7.15.0","eslint-plugin-n8n-nodes-base":"^1.16.1"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-freshbooks_0.1.1_1755449820293_0.180582640467414","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-08-16T18:16:11.941Z","modified":"2026-05-21T14:19:08.136Z","0.1.0":"2025-08-16T18:16:12.317Z","0.1.1":"2025-08-17T16:57:00.505Z"},"bugs":{"url":"https://github.com/bitovi/n8n-nodes-freshbooks/issues"},"author":{"name":"Roye","email":"roye@bitovi.com"},"license":"MIT","homepage":"https://github.com/bitovi/n8n-nodes-freshbooks#readme","keywords":["n8n-community-node-package"],"repository":{"url":"git+https://github.com/bitovi/n8n-nodes-freshbooks.git","type":"git"},"description":"N8N node to connect to FreshBooks","maintainers":[{"email":"justin@bitovi.com","name":"justinbmeyer"},{"email":"cherif.bouchelaghem@gmail.com","name":"cherif_b"},{"email":"alyshouman@gmail.com","name":"alishouman"},{"email":"os@bitovi.com","name":"bitovi-os"},{"email":"kylebnazario@gmail.com","name":"kyle-n"},{"email":"mhaynie@bitovi.com","name":"mhaynie_bitovi"},{"email":"brad@bitovi.com","name":"bmomberger-bitovi"},{"email":"fabioemoutinho@gmail.com","name":"fabioemoutinho"},{"email":"rich@limnous.com","name":"rlmcneary2"},{"email":"jennifer.wadella@gmail.com","name":"tehfedaykin"},{"email":"kphillips86@gmail.com","name":"phillipskevin"},{"email":"mick.mc.13@gmail.com","name":"mickmcgrath13"},{"email":"core@donejs.com","name":"bitovi-core-os"},{"email":"jane@bitovi.com","name":"janebitovi"},{"email":"DanD.Tran89@gmail.com","name":"dandamantran89"},{"email":"sandover@gmail.com","name":"sandover"}],"readme":"# @bitovi/n8n-nodes-freshbooks\n\nThis is an n8n community node. It lets you use FreshBooks in your n8n workflows.\n\nFreshBooks is a cloud-based accounting software designed for small businesses and freelancers, providing tools for invoicing, time tracking, expense management, and financial reporting.\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.\n\n[Installation](#installation)  \n[Operations](#operations)  \n[Credentials](#credentials)  \n[Compatibility](#compatibility)  \n[Usage](#usage)  \n[Resources](#resources)  \n[Version history](#version-history)  \n\n## Installation\n\nFollow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.\n\n- Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`\n- Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-freshbooks`\n\n## Operations\n\n### Clients\n\n- **List Clients**: Retrieve all clients from your FreshBooks account\n\n### Projects\n\n- **List Projects**: Get all projects for specified clients\n\n### Services\n\n- **List Services**: Get available services for a specific project\n\n### Time Tracking\n\n- **List Time Entries**: Retrieve time entries from your FreshBooks account\n- **Get Time Entry**: Retrieve a specific time entry by ID\n- **Create Time Entry**: Add a new time entry with client, project, service, note, date, and duration\n- **Update Time Entry**: Modify an existing time entry\n- **Delete Time Entry**: Remove a time entry\n\n### User\n\n- **Get User Info**: Retrieve current user information\n\n## Credentials\n\nThis node requires OAuth2 authentication with FreshBooks.\n\n- **Client ID**: Your FreshBooks OAuth2 client ID from your app registration\n- **Client Secret**: Your FreshBooks OAuth2 client secret from your app registration  \n- **Authorization URL**: `https://my.freshbooks.com/service/auth/oauth/authorize`\n\nTo set up OAuth2 credentials:\n\n1. Register your application in the FreshBooks Developer Portal\n2. Configure the redirect URI in your FreshBooks app settings\n3. Use the provided Client ID and Client Secret in your n8n credentials\n\n## Compatibility\n\n- Node version: 1\n- Tested with latest n8n version\n\n## Usage\n\nThis node provides comprehensive access to FreshBooks functionality for accounting and time tracking:\n\n### Time Tracking Operations\n\n#### Creating Time Entries\n\n- **Client ID**: Select the client for billing\n- **Project ID**: Associate with specific project\n- **Service ID**: Categorize the type of work performed\n- **Note**: Detailed description of work performed\n- **Date**: When the work was performed\n- **Duration**: Time spent in seconds (default: 28800 = 8 hours)\n- **Is Logged**: Whether the entry is marked as logged (default: true)\n\n#### Managing Time Entries\n\n- List all time entries with pagination support\n- Get specific time entries by ID\n- Update existing entries with new information\n- Delete time entries when needed\n\n### Filtering and Options\n\n#### Client Operations\n\n- Filter by visibility state (active/archived)\n- Sort by various criteria (updated date, created date, etc.)\n\n#### Project Operations\n\n- Filter projects by specific client IDs\n- Show only active projects\n- Exclude completed projects from results\n\n### Pagination Support\n\n- **Return All**: Get all results or limit the number returned\n- **Limit**: Set maximum number of results (default: 50)\n- Automatic pagination handling for large datasets\n\n### User Information\n\n- Retrieve current authenticated user details\n- Access business and account information\n\n## Resources\n\n- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)\n- [FreshBooks API documentation](https://www.freshbooks.com/api)\n- [FreshBooks Developer Portal](https://www.freshbooks.com/developers)\n\n## Version history\n\n- v0.1.0: Initial release\n  - Client, Project, Service, Time Tracking, and User operations\n  - Full CRUD support for time entries\n  - OAuth2 authentication\n  - Pagination support\n\n## Need help or have questions?\n\nNeed guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.\n\n## License\n\n[MIT](./LICENSE.md)\n","readmeFilename":"README.md"}