Skip to main content

​
Register an OAuth application

Create a FreshBooks developer application to enable OAuth 2.0 authentication.

1

Sign in to FreshBooks

Sign in to the FreshBooks Developer Portal.

  • Click Create New App.
2

Fill in application details

Complete the Create Application form.

  • Application Name: StackOne
  • Select an Application Type (for example, Private App).
  • Enter a brief Description (max 140 characters).
  • Website URL and Application Settings URL: enter any valid URL (these are not used by StackOne).
3

Add scopes

Under Scopes, click Add Scope and add each scope required by your integration.

4

Add the redirect URI and create the app

Under Redirect URIs, add the StackOne callback URL, then save the application.

  • Redirect URI: https://api.stackone.com/connect/oauth2/freshbooks/callback
  • Click the check icon to save the redirect URI.
  • Click Save to create the application.
5

Open the app from the apps list

After creation, you are returned to the All Apps list.

  • Click your newly created app (for example, S1DevTest) to open it.
6

Copy client credentials

Inside the app, copy the Client ID and Client Secret and store them securely for use later.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for FreshBooks:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select FreshBooks
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for FreshBooks.