Setup FreshBooks

Before you can access data from users using FreshBooks for their accounting, you need to set up a FreshBooks integration in the Railz Dashboard™. You'll need to:

  • Create a FreshBooks developer application.
  • Add your secure keys to Railz.

Create a FreshBooks Developer Application

  1. Create an account at freshbooks.com.
  2. Once logged in, visit https://my.freshbooks.com/#/developer and click Create an App.
FreshBooks Developer Portal - Create an App. Click to Expand.FreshBooks Developer Portal - Create an App. Click to Expand.

FreshBooks Developer Portal - Create an App. Click to Expand.

  1. Enter your app details.
FreshBooks Developer Portal - Edit Application. Click to Expand.FreshBooks Developer Portal - Edit Application. Click to Expand.

FreshBooks Developer Portal - Edit Application. Click to Expand.

  1. The Application Name is displayed to your users, so should identify you.
  2. The Redirect URIs must read: https://auth.railz.ai/freshbooks/railzConnect
FreshBooks Developer Portal - Redirect URIs. Click to Expand.FreshBooks Developer Portal - Redirect URIs. Click to Expand.

FreshBooks Developer Portal - Redirect URIs. Click to Expand.

  1. Set the Scopes to the following list to allow Read access for the data types that Railz supports.

user:profile:read
user:bills:read
user:billable_items:read
user:billable_items:write
user:bill_payments:read
user:business:read
user:bill_vendors:read
user:bill_vendors:write
user:clients:read

user:credit_notes:read
user:estimates:read
user:estimates:write
user:expenses:read
user:journal_entries:read
user:online_payments:read
user:payments:read
user:projects:read
user:retainers:read

user:taxes:read
user:billable_items:read
user:invoices:read
user:other_income:read
user:reports:read
user:teams:read
user:teams:write

❗️

Scopes for Pushing Data

If you need to push data to Freshbooks you will need to select the corresponding write scope. If the scopes you need are changed then businesses will need to re-authenticate with your app for the new scopes to be applied. We recommend setting all read and write scopes on setup to avoid reauthentication.

  1. Click Save to create your app.
  2. Select the small arrow next to the newly created app to display your secure keys. You'll need these for the next stage of the process.
FreshBooks Developer Portal - Client ID & Secret. Click to Expand.FreshBooks Developer Portal - Client ID & Secret. Click to Expand.

FreshBooks Developer Portal - Client ID & Secret. Click to Expand.

Add your Secure Keys to Railz

  1. Open the Railz Dashboard™ and log in.
  2. In the left sidebar navigation menu, go to Integrations > Accounting.
  3. Scroll down to the FreshBooks integration and click Manage.
Railz Integration Settings. Click to Expand.Railz Integration Settings. Click to Expand.

Railz Integration Settings. Click to Expand.

  1. Paste in your Client ID and Client Secret, and then click Save changes.
Railz Manage Accounting Integration. Click to Expand.Railz Manage Accounting Integration. Click to Expand.

Railz Manage Accounting Integration. Click to Expand.

  1. Enable your integration. Go back to Integrations > Accounting, and use the toggle to update the FreshBooks integration from Disabled to Enabled.

Did this page help you?