Skip to main content

FreshBooks

The FreshBooks connector enables easy and secure data synchronization between your application and your customers’ FreshBooks accounts through unified data models.

​
Authorization

The FreshBooks connector uses OAuth for secure authentication. When creating a connection, the required OAuth scopes are automatically configured based on your specific operations needs (e.g. genericContact::create, genericUser::list).

✓ Automatic token refresh handling
✓ Proactive insufficient permissions detection

View our step-by-step integration guideWhitelabel
Supported
You can choose to provide your own set of clientId and clientSecret for this connector from the Morph Cloud dashboard; allowing a fully whitelabled experience for your end-customers.
import { Morph } from "@runmorph/cloud";

const morph = Morph({ publicKey: "pk_demo_xxxxxxxxxxxxxxx", secretKey: "sk_demo_xxxxxxxxxxxxxxx"}); 

// create a new connection
const connection = morph.connections({ connectorId: "freshbooks", ownerId: "demo" });
await connection.create({ operations:[ "genericContact::list" ]});

// auhtorize the connection
const { auhtorizationUrl } = await connection.authorize();

// redirect the user to the auhtorizationUrl

Live Demo
Select a connector below to experience our seamless authentication flow and see how easy it is to connect third-party services.

​
Models

​
Generic

The FreshBooks connector seamlessly integrates with our unified genericContact model, enabling you to manage Contacts with rich data including firstName, lastName, phoneNumber, email and other key details

API Reference
GET/resources/genericContactList and Search FreshBooks Contacts
GET/resources/genericContact/:idRetrieve a FreshBooks Contact
POST/resources/genericContactCreate a FreshBooks Contact
PATCH/resources/genericContact/:idUpdate a FreshBooks Contact
DEL/resources/genericContact/:idDelete a FreshBooks Contact
Custom Fields
Supported
The FreshBooks connector supports our Field Mapping feature, enabling you or your customers to seamlessly map FreshBooks Contact custom fields to the unified contact model. This allows for flexible data synchronization while maintaining data consistency across all connectors.

view Contact model details

The FreshBooks connector seamlessly integrates with our unified genericCompany model, enabling you to manage Companies with rich data including name and other key details

API Reference
GET/resources/genericCompanyList and Search FreshBooks Companies
GET/resources/genericCompany/:idRetrieve a FreshBooks Company
POST/resources/genericCompanyCreate a FreshBooks Company
PATCH/resources/genericCompany/:idUpdate a FreshBooks Company
DEL/resources/genericCompany/:idDelete a FreshBooks Company
Custom Fields
Supported
The FreshBooks connector supports our Field Mapping feature, enabling you or your customers to seamlessly map FreshBooks Company custom fields to the unified company model. This allows for flexible data synchronization while maintaining data consistency across all connectors.

view Company model details

The FreshBooks connector seamlessly integrates with our unified genericUser model, enabling you to manage Users with rich data including firstName, lastName, email and other key details

API Reference
GET/resources/genericUserList and Search FreshBooks Users
GET/resources/genericUser/:idRetrieve a FreshBooks User
POST/resources/genericUserCreate a FreshBooks User
PATCH/resources/genericUser/:idUpdate a FreshBooks User
DEL/resources/genericUser/:idDelete a FreshBooks User
Custom Fields
Supported
The FreshBooks connector supports our Field Mapping feature, enabling you or your customers to seamlessly map FreshBooks User custom fields to the unified user model. This allows for flexible data synchronization while maintaining data consistency across all connectors.

view User model details

The FreshBooks connector seamlessly integrates with our unified genericWorkspace model, enabling you to manage Workspaces with rich data including name and other key details

API Reference
GET/resources/genericWorkspaceList and Search FreshBooks Workspaces
GET/resources/genericWorkspace/:idRetrieve a FreshBooks Workspace
POST/resources/genericWorkspaceCreate a FreshBooks Workspace
PATCH/resources/genericWorkspace/:idUpdate a FreshBooks Workspace
DEL/resources/genericWorkspace/:idDelete a FreshBooks Workspace
Custom Fields
Supported
The FreshBooks connector supports our Field Mapping feature, enabling you or your customers to seamlessly map FreshBooks Workspace custom fields to the unified workspace model. This allows for flexible data synchronization while maintaining data consistency across all connectors.

view Workspace model details

​
Accounting

The FreshBooks connector seamlessly integrates with our unified accountingInvoice model, enabling you to manage Invoices with rich data including number, customer, company, issueDate, dueDate and other key details

API Reference
GET/resources/accountingInvoiceList and Search FreshBooks Invoices
GET/resources/accountingInvoice/:idRetrieve a FreshBooks Invoice
POST/resources/accountingInvoiceCreate a FreshBooks Invoice
PATCH/resources/accountingInvoice/:idUpdate a FreshBooks Invoice
DEL/resources/accountingInvoice/:idDelete a FreshBooks Invoice

view Invoice model details

The FreshBooks connector seamlessly integrates with our unified accountingInvoiceItem model, enabling you to manage Invoice Items with rich data including description, quantity, unitPrice, amount, taxRate and other key details

API Reference
GET/resources/accountingInvoiceItemList and Search FreshBooks Invoice Items
GET/resources/accountingInvoiceItem/:idRetrieve a FreshBooks Invoice Item
POST/resources/accountingInvoiceItemCreate a FreshBooks Invoice Item
PATCH/resources/accountingInvoiceItem/:idUpdate a FreshBooks Invoice Item
DEL/resources/accountingInvoiceItem/:idDelete a FreshBooks Invoice Item

view Invoice Item model details

​
Custom

Supported
Can’t find the unified model you need? The FreshBooks connector supports your own custom model.

​
Webhooks

The FreshBooks connector supports real-time event subscriptions, allowing you to receive instant notifications when records are created, updated, or deleted. Below are the supported models and their corresponding triggers.
ModelsCreatedUpdatedDeletedAPI Reference
genericContactview event
genericCompanyview event
genericUserview event
genericWorkspaceview event
accountingInvoiceview event
accountingInvoiceItemview event

​
Proxy

Supported
The FreshBooks connector supports our Proxy Request feature, allowing you to directly call any endpoints from FreshBooks’s public API without needing to handle authentication. Your customer’s token will be automatically set and refreshed as needed, enabling quick implementation of custom connector behaviors. View API Reference.