01
Auto-categorise
- New transaction lands
- Agent classifies based on history + memo
- Writes the category back
FreshBooks
10 tools available
FreshBooks is a cloud-based accounting software service designed for small and medium-sized businesses, offering features like invoicing, expense tracking, and time management.
Connect FreshBooks to Definable to auto-categorise transactions, draft invoices on closed deals, surface cash-flow signals. Personas call FreshBooks's 10 tools directly from chat or scheduled flows. Pair with a finance persona to keep books current and surface what needs human review.
Common workflows with FreshBooks
02
Invoice from event
- Triggered by a closed deal
- Persona drafts the invoice
- Sends with the right terms
03
Cash-flow digest
- Pull this week's ins/outs
- Highlight unusual entries
- Email a one-pager
FreshBooks actions 10
Every FreshBooks action below is a callable tool any Definable persona can invoke.
Create Webhook
Register a new webhook callback for a FreshBooks account. Webhooks notify your application when specified events occur (e.g., when invoices are created, clients are updated, or payments are received). **Prerequisites:** Obtain a valid account_id using the List Businesses action first. **Important Notes:** - FreshBooks implements a verification mechanism to ensure you own the callback URI. The 'verified' field will initially be false. - Your webhook endpoint must respond with a 2xx HTTP status code. Any other status code (including 3xx redirects) is treated as a failure. - Webhook requests have a 10-second timeout. - Requires 'user:webhooks:write' OAuth scope. **Common Event Types:** client.create, client.update, client.delete, invoice.create, invoice.update, invoice.delete, payment.create, payment.update, payment.delete, expense.create, expense.update, expense.delete.
Delete Webhook
Delete a webhook callback from a FreshBooks account. Use when you need to remove an existing webhook subscription that is no longer needed.
Get Business Users
Retrieves staff identities and members for a specific FreshBooks business. This action returns detailed information about all staff members (owners, admins, employees) in a business group, including their roles, email addresses, and active status. Use this to discover team members before assigning time entries or tasks.
List Businesses
List all businesses associated with the authenticated user. This action retrieves business membership information from the FreshBooks Identity endpoint, showing all businesses the user has access to along with their role in each business. The business_id from this response is required for many other FreshBooks API calls.
List Clients
Retrieves all clients for a FreshBooks account. Clients are entities you send invoices to. Supports pagination, filtering by email/user ID/visibility state, sorting, and includes optional balance data (outstanding, credit, draft, overdue).
List Journal Entries
Retrieves all journal entries for a FreshBooks business account. Journal entries are the building blocks of financial accounting, recording all business transactions including invoices, payments, credits, and expenses. Use this action to get a comprehensive view of your accounting records.
List Projects
Retrieves all projects associated with a FreshBooks business account. This action returns a paginated list of projects with comprehensive details including client information, billing rates, budget, completion status, team members, and associated services. Use this to discover available projects before performing project-specific operations. **Prerequisites:** Obtain a valid business_id using the List Businesses action first. **Use Cases:** - Get all projects for time tracking or invoicing - Find projects by client, status, or date range - Monitor project completion and budget tracking - Retrieve team assignments and project groups **Response:** Returns an empty list if no projects exist or match the filters.
List Webhooks
List all webhook callbacks registered for a FreshBooks account. Webhooks notify your application when events occur (e.g., invoice creation, payment received). Use this to discover what webhook callbacks are currently active for an account before creating or managing webhook subscriptions.
Register as a New User
Register a new user account in FreshBooks. Returns an access token upon successful registration. Use this action when you need to create a new FreshBooks user account programmatically with their business information.
Update Webhook
Update or verify a FreshBooks webhook callback. Use this to verify a newly created webhook by providing the verification code, or to request a new verification code be sent to the callback URI. **Prerequisites:** You need the account_id (from List Businesses as business_uuid) and callback_id (from webhook creation). **Use Cases:** - Verify a webhook after creation by providing the verifier code received at your callback URI - Request a new verification code if the original was lost or expired (set resend=true) **Important:** The verifier and resend parameters are mutually exclusive - provide only one per request.
Altoviz
Altoviz is a cloud-based billing and invoicing platform for businesses, offering online payments, expense tracking, document management, and customizable invoices.
Apaleo
Apaleo is a cloud-based property management platform handling reservations, billing, and daily operations for hospitality businesses
Brex
Brex provides corporate credit cards, spend management, and financial tools tailored for startups and tech businesses to optimize cash flow, accounting, and growth
Chaser
Chaser is an accounts receivable automation software that helps businesses automate invoice reminders and get paid faster.
Coupa
Coupa provides a comprehensive business spend management platform with procurement, invoicing, and expense capabilities.
Erpnext
Free and open-source integrated Enterprise Resource Planning software built on Frappe Framework
Frequently asked questions
What can I automate with FreshBooks on Definable?
Anything FreshBooks exposes through its API. Common accounting workflows on Definable include auto-categorise transactions, draft invoices on closed deals, surface cash-flow signals. Personas can call any of the 10 FreshBooks tools directly, then chain the result into another integration without you writing code.
How does FreshBooks authentication work?
FreshBooks uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the FreshBooks integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 10 FreshBooks tools. You only need a separate FreshBooks subscription if FreshBooks itself charges per seat or per API call.
Is using FreshBooks through Definable secure?
Every call from a persona to FreshBooks is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with FreshBooks on Definable?
Sign up for Definable, open the integrations page, find FreshBooks, and connect via OAuth or API key. You can immediately attach FreshBooks to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What FreshBooks actions does Definable expose?
Definable exposes all 10 FreshBooks actions as callable tools — including `Create Webhook`, `Delete Webhook`, `Get Business Users`, plus 7 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with FreshBooks?
Wire it up in minutes. No coding required.