Prerequisites
The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the FreshBooks connector page.How webhooks are set up
StackOne creates and manages the FreshBooks webhook callbacks automatically when the account is connected, one callback per event you enable, and removes them when the account is disconnected. FreshBooks confirms each new callback by sending a verification code to StackOne, which StackOne returns for you, so there is nothing to configure in FreshBooks.
Available webhook events
The following FreshBooks events can be enabled. Only events selected in StackOne get a callback, so FreshBooks does not deliver events that are not selected. Each event needs the matching read permission on the connected account, such as user:invoices:read for invoice events; bill vendor events need user:bill_vendors:read.
Invoice events
Events related to invoices and recurring invoice profiles.
- Invoice Created (
invoice.create) — Fired when an invoice is created - Invoice Updated (
invoice.update) — Fired when an invoice is updated - Invoice Deleted (
invoice.delete) — Fired when an invoice is deleted - Invoice Sent by Email (
invoice.sendByEmail) — Fired when an invoice is sent to a client by email - Recurring Invoice Profile Created (
recurring.create) — Fired when a recurring invoice profile is created - Recurring Invoice Profile Updated (
recurring.update) — Fired when a recurring invoice profile is updated - Recurring Invoice Profile Deleted (
recurring.delete) — Fired when a recurring invoice profile is deleted
Estimate and credit note events
Events related to estimates and credit notes issued to clients.
- Estimate Created (
estimate.create) — Fired when an estimate is created - Estimate Updated (
estimate.update) — Fired when an estimate is updated - Estimate Deleted (
estimate.delete) — Fired when an estimate is deleted - Estimate Sent by Email (
estimate.sendByEmail) — Fired when an estimate is sent to a client by email - Credit Note Created (
credit_note.create) — Fired when a credit note is created - Credit Note Updated (
credit_note.update) — Fired when a credit note is updated - Credit Note Deleted (
credit_note.delete) — Fired when a credit note is deleted
Payment and client events
Events related to invoice payments and clients.
- Payment Created (
payment.create) — Fired when an invoice payment is created - Payment Updated (
payment.update) — Fired when an invoice payment is updated - Payment Deleted (
payment.delete) — Fired when an invoice payment is deleted - Client Created (
client.create) — Fired when a client is created - Client Updated (
client.update) — Fired when a client is updated - Client Deleted (
client.delete) — Fired when a client is deleted
Expense and bill events
Events related to expenses, expense categories, vendor bills and bill vendors.
- Expense Created (
expense.create) — Fired when an expense is created - Expense Updated (
expense.update) — Fired when an expense is updated - Expense Deleted (
expense.delete) — Fired when an expense is deleted - Expense Category Created (
category.create) — Fired when an expense category is created - Expense Category Updated (
category.update) — Fired when an expense category is updated - Expense Category Deleted (
category.delete) — Fired when an expense category is deleted - Bill Created (
bill.create) — Fired when a vendor bill is created - Bill Updated (
bill.update) — Fired when a vendor bill is updated - Bill Deleted (
bill.delete) — Fired when a vendor bill is deleted - Bill Vendor Created (
bill_vendor.create) — Fired when a bill vendor is created - Bill Vendor Updated (
bill_vendor.update) — Fired when a bill vendor is updated - Bill Vendor Deleted (
bill_vendor.delete) — Fired when a bill vendor is deleted
Item, service and tax events
Events related to billable items, services and taxes.
- Item Created (
item.create) — Fired when a billable item is created - Item Updated (
item.update) — Fired when a billable item is updated - Item Deleted (
item.delete) — Fired when a billable item is deleted - Service Created (
service.create) — Fired when a service is created - Service Updated (
service.update) — Fired when a service is updated - Service Deleted (
service.delete) — Fired when a service is deleted - Tax Created (
tax.create) — Fired when a tax is created - Tax Updated (
tax.update) — Fired when a tax is updated - Tax Deleted (
tax.delete) — Fired when a tax is deleted
Project and time tracking events
Events related to projects and time entries.
- Project Created (
project.create) — Fired when a project is created - Project Updated (
project.update) — Fired when a project is updated - Project Deleted (
project.delete) — Fired when a project is deleted - Time Entry Created (
time_entry.create) — Fired when a time entry is created - Time Entry Updated (
time_entry.update) — Fired when a time entry is updated - Time Entry Deleted (
time_entry.delete) — Fired when a time entry is deleted
Delivery format
Details of how FreshBooks delivers events to StackOne.
Review the notification fields
FreshBooks sends each event as a form-encoded POST with name (the event, such as invoice.create), object_id (the record that changed), account_id, business_id and identity_id (the user who made the change). The payload carries no record details, so fetch the record by object_id with the matching action, such as getting the invoice for invoice events.
Expect delayed delivery
FreshBooks does not guarantee delivery timing; events can arrive from seconds to several minutes after the change. Events are sent for changes made in FreshBooks and by other apps using the FreshBooks API. The payload has no event timestamp, so StackOne uses the time the event was received.