Requirements
Connecting FreshBooks takes an active account plus OAuth client credentials, granted by signing in with your account — no other setup is required.[3]https://www.freshbooks.com
Get your FreshBooks credentials
You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.
- Business IDtext
Optional. Only needed when your login has more than one business. Enter the numeric business ID of the one to use (shown in Settings → Business, or ask FreshBooks support). Leave empty to use the business you own.
[1] - Client IDtextRequired
Create an app in the developer portal (my.freshbooks.com/#/developer) and copy its Client ID. Add https://wextl.com/api/oauth/app/callback as its redirect URI. Give the app read and write access to every area you plan to use: clients, invoices, estimates, credit notes, payments, online payments, other income, expenses, bills, bill payments, vendors, items and services, taxes, projects, time entries, retainers, team, business, reports, journal entries and accounts, uploads. Your profile is always included.
[1] - Client SecretpasswordRequired
Copy the Client Secret from the same FreshBooks app.
[1]
Connect FreshBooks in WEXTL
- Log in to your WEXTL account, add the FreshBooks node module to your workflow, and click Create new credential.
- Optional: In the Credential name field, enter a name for the credential.
- Enter the authentication credentials you copied from your FreshBooks account, or follow the on-screen instructions to create the credential.
- If prompted, authenticate your account and confirm access.
- If you want to make changes to your credential in the future, follow the steps in Manage credentials →
Notes
Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →
FreshBooks node modules
The list below is a reference of every FreshBooks node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.
Expand any FreshBooks node module below to see exactly what it takes in, what it returns, and what connection it needs.
Output fields[3]
| Field | Type |
|---|---|
ID | number |
User ID | number |
Accounting System ID | text |
UUID | text |
First Name | text |
Last Name | text |
Organization | text |
45other output fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Expense ID | number |
Account ID | text |
Accounting System ID | text |
Account Name | text |
Amount | object |
Amount | text |
Currency Code | text |
Background Job ID | number |
26other output fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Invoice ID | number |
UUID | text |
Account ID | text |
Accounting System ID | text |
Invoice Number | text |
Client ID | number |
58other output fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Note | text |
Duration (seconds) | number |
Project ID | number |
Client ID | number |
Logged | boolean |
Started At | date |
2other output fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Log ID | number |
Accounting System ID | text |
Amount | object |
Amount | text |
Currency Code | text |
Bulk Payment ID | number |
Client ID | number |
Credit ID | number |
12other output fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Title | text |
Description | text |
Client ID | number |
Project Type | text |
Billing Method | text |
Fixed Price | text |
13other output fields
Output fields[3]
| Field | Type |
|---|---|
Business ID | number |
Name | text |
Account ID | text |
Team Group | object |
Group ID | number |
Category | text |
Members | array |
Date Format | text |
Address | object |
Address ID | number |
Street | text |
City | text |
Province | text |
Country | text |
Postal Code | text |
Phone Number | text |
Input fields[3]
| Field | Type |
|---|---|
Start Date | date |
End Date | date |
Currency Code | text |
Output fields[3]
| Field | Type |
|---|---|
Company Name | text |
Download Token | text |
Start Date | text |
End Date | text |
Currency Code | text |
Activities | array |
Summary | object |
Ending Balance | object |
Gross Cash Inflow | object |
Gross Cash Outflow | object |
Net Cash Change | object |
Starting Balance | object |
Output fields[3]
| Field | Type |
|---|---|
Date Format | text |
Description Heading | text |
Hours Heading | text |
Banner Vertical Position | number |
Banner Path | text |
Logo Path | text |
Invoice ID | number |
10other output fields
Output fields[3]
| Field | Type |
|---|---|
Payment Options | object |
Gateway Name | text |
Accepts Credit Cards | boolean |
Accepts ACH Transfers | boolean |
Accepts BACS Debit | boolean |
Accepts SEPA Debit | boolean |
Accepts PayPal Smart Checkout | boolean |
Allows Partial Payments | boolean |
Entity Type | text |
Entity ID | text |
Input fields[3]
| Field | Type |
|---|---|
Start Date | date |
End Date | date |
Currency Code | text |
Group By | choice |
Exclude Personal Expenses | choice |
Include Project Expenses | choice |
Client | choice |
1other input field
Output fields[3]
| Field | Type |
|---|---|
Company Name | text |
Download Token | text |
Start Date | text |
End Date | text |
Currency Code | text |
Groups | array |
Summary | object |
Total Amount | object |
Total Expense Refund Amount | object |
3other output fields
Output fields[3]
| Field | Type |
|---|---|
Summaries | array |
Summary | object |
Input fields[3]
| Field | Type |
|---|---|
Start Date | date |
End Date | date |
Currency Code | text |
Clients | choice |
Statuses | choice |
Date Type | choice |
Output fields[3]
| Field | Type |
|---|---|
Status Filter | array |
End Date | text |
Client Filter | array |
Date Type | text |
Clients | array |
Summary | object |
Total | object |
Paid | object |
Outstanding | object |
Download Token | text |
Company Name | text |
Start Date | text |
Currency Code | text |
Input fields[3]
| Field | Type |
|---|---|
InvoiceRequired | choice |
Output fields[3]
| Field | Type |
|---|---|
Payment Options | object |
Gateway Name | text |
Accepts Credit Cards | boolean |
Accepts ACH Transfers | boolean |
Accepts BACS Debit | boolean |
Accepts SEPA Debit | boolean |
Accepts PayPal Smart Checkout | boolean |
Allows Partial Payments | boolean |
Entity Type | text |
Entity ID | text |
Output fields[3]
| Field | Type |
|---|---|
Gateway Connections | array |
Gateway Connection | object |
Output fields[3]
| Field | Type |
|---|---|
Abilities | array |
Output fields[3]
| Field | Type |
|---|---|
Time Entries | array |
Input fields[3]
| Field | Type |
|---|---|
Vendor | choice |
Statuses | choice |
Bills | choice |
Currency Code | text |
Issued On or After | date |
Issued On or Before | date |
Include | choice |
1other input field
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Vendor ID | number |
Bill Number | text |
Issue Date | text |
Due Date | text |
Due Offset Days | number |
Currency Code | text |
14other output fields
Input fields[3]
| Field | Type |
|---|---|
Clients | choice |
Client ID | text |
Email | text |
Email Contains | text |
First Name Contains | text |
Last Name Contains | text |
Organization Contains | text |
15other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
User ID | number |
Accounting System ID | text |
UUID | text |
First Name | text |
Last Name | text |
Organization | text |
45other output fields
Input fields[3]
| Field | Type |
|---|---|
Estimates | choice |
Estimate ID | text |
Estimate Number | text |
Estimate Number Contains | text |
Notes Contain | text |
Status | choice |
Statuses | choice |
12other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Estimate ID | number |
Estimate Number | text |
Client ID | number |
Accounting System ID | text |
Account ID | text |
Owner ID | number |
37other output fields
Input fields[3]
| Field | Type |
|---|---|
Expenses | choice |
Expense ID | text |
Clients | choice |
Client ID | text |
Not Client ID | text |
Staff | choice |
Staff ID | text |
24other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Expense ID | number |
Accounting System ID | text |
Account ID | number |
Account Name | text |
Amount | object |
Amount | text |
Currency Code | text |
Background Job ID | number |
26other output fields
Input fields[3]
| Field | Type |
|---|---|
Invoices | choice |
Invoice ID | text |
Invoice Number | text |
Invoice Number Contains | text |
Notes Contain | text |
Status | choice |
Statuses | choice |
20other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Invoice ID | number |
Account ID | text |
Accounting System ID | text |
UUID | text |
Invoice Number | text |
Client ID | number |
58other output fields
Input fields[3]
| Field | Type |
|---|---|
AccountRequired | choice |
Start Date | date |
End Date | date |
Include Sub Accounts | choice |
Currency Code | text |
Limit | number |
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Entry | object |
ID | number |
Entry ID | number |
Client ID | number |
Expense ID | number |
Invoice ID | number |
Payment ID | number |
Income ID | number |
Credit ID | number |
Accounting System ID | text |
Account | object |
UUID | text |
Name | text |
Type | text |
Number | text |
Parent Account UUID | text |
Date | text |
Detail Type | text |
Name | text |
Description | text |
4other output fields
Input fields[3]
| Field | Type |
|---|---|
Payments | choice |
Payment ID | text |
Clients | choice |
Client ID | text |
Customer ID | text |
Invoice | choice |
Paid On or After | date |
14other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Log ID | number |
Accounting System ID | text |
Amount | object |
Amount | text |
Currency Code | text |
Bulk Payment ID | number |
Client ID | number |
Credit ID | number |
12other output fields
Input fields[3]
| Field | Type |
|---|---|
Recurring Invoice Profiles | choice |
Profile ID | text |
Client | choice |
Clients | choice |
Currency Code | text |
Includes Unbilled Time | choice |
Include | choice |
1other input field
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Profile ID | number |
Owner ID | number |
Client ID | number |
Accounting System ID | text |
Frequency | text |
Start Date | text |
34other output fields
Input fields[3]
| Field | Type |
|---|---|
Staff Members | choice |
Staff ID | text |
User Level | choice |
Name Contains | text |
Note Contains | text |
Phone Contains | text |
Email Contains | text |
1other input field
Output fields[3]
| Field | Type |
|---|---|
ID | number |
User ID | number |
Accounting System ID | text |
First Name | text |
Last Name | text |
Display Name | text |
Organization | text |
23other output fields
Input fields[3]
| Field | Type |
|---|---|
Tasks | choice |
Task ID | text |
Projects | choice |
Billable | choice |
Rate At Least | number |
Rate At Most | number |
Updated On or After | date |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Task ID | number |
Name | text |
Description | text |
Task Name | text |
Task Description | text |
Rate | object |
Amount | text |
Currency Code | text |
5other output fields
Input fields[3]
| Field | Type |
|---|---|
Billable | choice |
Billed | choice |
Include Deleted | choice |
All Team Members | choice |
Include Running Timers | choice |
Client | choice |
Team Member | choice |
4other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Team Member Identity ID | number |
Timer | object |
Timer ID | number |
Is Running | boolean |
Is Logged | boolean |
Started At | date |
Created At | date |
Duration (seconds) | number |
10other output fields
Input fields[3]
| Field | Type |
|---|---|
InvoiceRequired | choice |
Payment GatewayRequired | choice |
Accept Credit Cards | choice |
Accept ACH Transfers | choice |
Accept BACS Debit | choice |
Accept SEPA Debit | choice |
Accept PayPal Smart Checkout | choice |
1other input field
Output fields[3]
| Field | Type |
|---|---|
Payment Options | object |
Gateway Name | text |
Accepts Credit Cards | boolean |
Accepts ACH Transfers | boolean |
Accepts BACS Debit | boolean |
Accepts SEPA Debit | boolean |
Accepts PayPal Smart Checkout | boolean |
Allows Partial Payments | boolean |
Entity Type | text |
Entity ID | text |
Input fields[3]
| Field | Type |
|---|---|
ClientRequired | choice |
Credit Type | choice |
Create Date | date |
Credit Number | text |
Currency Code | text |
Language | text |
Notes | text |
2other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Credit ID | number |
Credit Number | text |
Credit Type | text |
Client ID | number |
Accounting System ID | text |
Create Date | text |
28other output fields
Input fields[3]
| Field | Type |
|---|---|
ClientRequired | choice |
Create DateRequired | date |
Estimate Number | text |
Currency Code | text |
Language | text |
Template | text |
Discount Value | text |
17other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Estimate ID | number |
Estimate Number | text |
Client ID | number |
Accounting System ID | text |
Account ID | text |
Owner ID | number |
37other output fields
Input fields[3]
| Field | Type |
|---|---|
CategoryRequired | choice |
Amount | text |
Currency Code | text |
Expense Date | date |
Staff Member | choice |
Vendor | text |
Notes | text |
10other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Expense ID | number |
Accounting System ID | text |
Account ID | number |
Account Name | text |
Amount | object |
Amount | text |
Currency Code | text |
Background Job ID | number |
26other output fields
Input fields[3]
| Field | Type |
|---|---|
ClientRequired | choice |
Invoice DateRequired | date |
Lines | array |
Line | object |
Invoice Number | text |
Due In Days | number |
Currency Code | text |
Language | text |
27other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Invoice ID | number |
Account ID | text |
Accounting System ID | text |
UUID | text |
Invoice Number | text |
Client ID | number |
59other output fields
Input fields[3]
| Field | Type |
|---|---|
InvoiceRequired | choice |
AmountRequired | text |
Payment DateRequired | date |
Currency Code | text |
Payment Type | choice |
Note | text |
Notify Client | choice |
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Log ID | number |
Accounting System ID | text |
Amount | object |
Amount | text |
Currency Code | text |
Bulk Payment ID | number |
Client ID | number |
Credit ID | number |
12other output fields
Input fields[3]
| Field | Type |
|---|---|
ClientRequired | choice |
Start DateRequired | date |
FrequencyRequired | text |
Number of InvoicesRequired | number |
Email On Creation | choice |
Send By Ground Mail | choice |
Disable | choice |
24other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Profile ID | number |
Owner ID | number |
Client ID | number |
Accounting System ID | text |
Frequency | text |
Start Date | text |
34other output fields
Input fields[3]
| Field | Type |
|---|---|
Client | choice |
Start Date | date |
Next Period Start Date | date |
Fee | number |
Excess Rate | number |
Budgeted Time (seconds) | number |
Active | choice |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Business ID | number |
System ID | number |
Invoice Profile ID | number |
Client ID | number |
Start Date | date |
Next Period Start Date | date |
6other output fields
Input fields[3]
| Field | Type |
|---|---|
Is LoggedRequired | choice |
Duration (seconds) | number |
Started At | date |
Note | text |
Client | choice |
Project | choice |
Service | choice |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Team Member Identity ID | number |
Timer | object |
Timer ID | number |
Is Running | boolean |
Is Logged | boolean |
Started At | date |
Created At | date |
Duration (seconds) | number |
10other output fields
Input fields[3]
| Field | Type |
|---|---|
Vendor Name | text |
Primary Contact First Name | text |
Primary Contact Last Name | text |
Primary Contact Email | text |
Phone | text |
Website | text |
Street | text |
11other input fields
Output fields[3]
| Field | Type |
|---|---|
Vendor ID | number |
Vendor Name | text |
Primary Contact First Name | text |
Primary Contact Last Name | text |
Primary Contact Email | text |
Phone | text |
Website | text |
17other output fields
Input fields[3]
| Field | Type |
|---|---|
Credit NoteRequired | choice |
Client | choice |
Credit Type | choice |
Create Date | date |
Credit Number | text |
Currency Code | text |
Language | text |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Credit ID | number |
Credit Number | text |
Credit Type | text |
Client ID | number |
Accounting System ID | text |
Create Date | text |
28other output fields
Input fields[3]
| Field | Type |
|---|---|
EstimateRequired | choice |
Client | choice |
Create Date | date |
Estimate Number | text |
Currency Code | text |
Language | text |
Template | text |
18other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Estimate ID | number |
Estimate Number | text |
Client ID | number |
Accounting System ID | text |
Account ID | text |
Owner ID | number |
37other output fields
Input fields[3]
| Field | Type |
|---|---|
ExpenseRequired | choice |
Category | choice |
Amount | text |
Currency Code | text |
Expense Date | date |
Staff Member | choice |
Vendor | text |
10other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Expense ID | number |
Accounting System ID | text |
Account ID | number |
Account Name | text |
Amount | object |
Amount | text |
Currency Code | text |
Background Job ID | number |
26other output fields
Input fields[3]
| Field | Type |
|---|---|
InvoiceRequired | choice |
Client | choice |
Invoice Date | date |
Lines | array |
Line | object |
Online Payment Gateways | choice |
Invoice Number | text |
Due In Days | number |
22other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Invoice ID | number |
Account ID | text |
Accounting System ID | text |
UUID | text |
Invoice Number | text |
Client ID | number |
59other output fields
Input fields[3]
| Field | Type |
|---|---|
PaymentRequired | choice |
Invoice | choice |
Amount | text |
Currency Code | text |
Payment Date | date |
Payment Type | choice |
Note | text |
1other input field
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Log ID | number |
Accounting System ID | text |
Amount | object |
Amount | text |
Currency Code | text |
Bulk Payment ID | number |
Client ID | number |
Credit ID | number |
12other output fields
Input fields[3]
| Field | Type |
|---|---|
Recurring Invoice ProfileRequired | choice |
Client | choice |
Start Date | date |
Frequency | text |
Number of Invoices | number |
Email On Creation | choice |
Send By Ground Mail | choice |
25other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Profile ID | number |
Owner ID | number |
Client ID | number |
Accounting System ID | text |
Frequency | text |
Start Date | text |
34other output fields
Input fields[3]
| Field | Type |
|---|---|
RetainerRequired | choice |
Client | choice |
Start Date | date |
Next Period Start Date | date |
Fee | number |
Excess Rate | number |
Budgeted Time (seconds) | number |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Business ID | number |
System ID | number |
Invoice Profile ID | number |
Client ID | number |
Start Date | date |
Next Period Start Date | date |
6other output fields
Input fields[3]
| Field | Type |
|---|---|
Time EntryRequired | choice |
Is Logged | choice |
Duration (seconds) | number |
Started At | date |
Note | text |
Client | choice |
Project | choice |
4other input fields
Output fields[3]
| Field | Type |
|---|---|
ID | number |
Team Member Identity ID | number |
Timer | object |
Timer ID | number |
Is Running | boolean |
Is Logged | boolean |
Started At | date |
Created At | date |
Duration (seconds) | number |
10other output fields
Input fields[3]
| Field | Type |
|---|---|
VendorRequired | choice |
Vendor Name | text |
Primary Contact First Name | text |
Primary Contact Last Name | text |
Primary Contact Email | text |
Phone | text |
Website | text |
12other input fields
Output fields[3]
| Field | Type |
|---|---|
Vendor ID | number |
Vendor Name | text |
Primary Contact First Name | text |
Primary Contact Last Name | text |
Primary Contact Email | text |
Phone | text |
Website | text |
17other output fields
Templates
Look for FreshBooks templates in the WEXTL template library.
Browse templates →Explore alternative apps
- Candis[2]Accounts-payable automation for invoices, approvals, and ERP exports.
- BillAccounts-payable and receivable — manage bills, invoices, vendors, and payments.
- BlingBrazilian ERP and ecommerce back-office platform for invoices, inventory, orders, and contacts.
- bexioBusiness software for small businesses and startups.
- CapiumCloud accounting and practice management platform for accountants, covering invoicing, expenses, payments, and client communications.
References
- WEXTL® FreshBooks Source Code connector implementation.
- Our users use cases and automations.
- Official API Documentation for FreshBooks.
- WEXTL® visual workflow builder data.
Last updated: Oct 1, 2026 05:38