Register an OAuth application
Register an application in the FreeAgent Developer Dashboard to obtain OAuth credentials for API access.
Sign in to the FreeAgent Developer Dashboard
Sign in to your FreeAgent Developer account.
- If you don’t have a developer account, click Sign up to create one.
Navigate to My Apps
Click My Apps in the top navigation bar, then click Create New App.
Create a new app
Complete the Create a new app form.
- Enter a Name (e.g.,
StackOne Integration) - Enter a Description for your app
- Set the OAuth Redirect URIs to the Callback URL from your Connector Profile
- Leave Enable Accountancy Practice API unchecked — it only applies to accountancy-practice accounts that manage multiple clients, and checking it is not needed for a standard FreeAgent connection.
- Click Create App
Copy Client credentials
After creating the app, the OAuth credentials are displayed on the app details page.
- Copy the OAuth identifier (this is your Client ID)
- Copy the OAuth secrets value (this is your Client Secret)
- Store both values securely for use later
Account access
FreeAgent’s OAuth authorization does not use selectable permission scopes. When you connect an account, FreeAgent shows an Approve account access screen naming the app and asking the user to Approve or Cancel — approving grants the connection full access to that FreeAgent account, equivalent to what the API as a whole can do, with no narrower option.
Approve account access
When linking the account, sign in with an active FreeAgent account and click Approve on the authorization screen to grant access.
Select Environment
When creating the connection in the StackOne Connector profile, select an Environment
(Production or Sandbox) matching the FreeAgent account you are connecting —
Production for a live FreeAgent account, or Sandbox for a free trial account.
Create the StackOne Connector Profile
Create a Connector Profile
Link an Account