Skip to content

FreshBooks

Install FreshBooks integration

The FreshBooks integration can be found here. Please install it in your environments before proceeding with the steps below.

Use your own FreshBooks OAuth app

Truto connects FreshBooks accounts through its own OAuth app, so this step is optional. To show your own app on the consent screen instead:

  1. Create an OAuth app in FreshBooks and add https://api.truto.one/connect/freshbooks/callback as its redirect URL. If you use a redirect URL on your own domain, add that URL instead.
  2. Enter the app's Client ID and Client Secret on the installed FreshBooks integration. See Overriding OAuth credentials.

Connecting a FreshBooks account

  1. Click on Connect Account Click connect account

  2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection link Get connection link

  3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their FreshBooks account. Share connection link

  4. Select FreshBooks Select FreshBooks

  5. You'll now be asked to log in to your FreshBooks account and allow access to Truto. Go through the steps.

  6. You should now see a connection successful message. You can now close this tab.

  7. Go to your Truto account, and you should see the new FreshBooks integration under Integrated Accounts. Click on the Account ID to view the details and initiate API calls.