Skip to main content

​
Create an OAuth application

Clear Books uses OAuth 2.0. You create a confidential OAuth application in the Clear Books developer portal to obtain a Client ID and Client Secret, then paste them into the StackOne Connector profile.

1

Sign in to Clear Books

Sign in to your Clear Books account.

  • Enter your Email and click Continue, then enter your password.
  • The developer portal is only available to the account owner or a user with access to the business.
The Clear Books Log in screen with the Email field and Continue button
2

Enable multi-factor authentication

Clear Books requires multi-factor authentication before you can open the developer portal. Open your account Security settings, select Multi-factor authentication, and make sure Authenticator app is enabled.

  • If it is not already enabled, expand Authenticator app, scan the QR code with an authenticator app, and enter the generated code to turn it on.
  • Without multi-factor authentication, Clear Books blocks access to the developer portal.
The Security page with Multi-factor authentication selected and Authenticator app enabled
3

Create a new app

Open the Clear Books developer portal and, on the My apps page, click New app.

The My apps page in the developer portal with the New app button highlighted
4

Enter the app details

Complete the App details form, set the Redirect URL, and click Save.

  • App name — a name for the application, such as StackOne Integration.
  • App description — a short description of the integration.
  • Responsible company or individual name and Contact email address — your company name and a contact email.
  • Set the Redirect URL to: https://api.stackone.com/connect/oauth2/clearbooks/callback
  • Only confidential clients using the authorization code grant are supported.
The New app form with the Redirect URL field and Save button highlighted
5

Copy your Client ID and Client Secret

After you save, Clear Books displays your Client ID and Client secret. Copy both and paste them into the Client ID and Client Secret fields in the StackOne Connector profile.

  • The Client secret is only displayed once and cannot be retrieved later, so store it securely for use later.
  • You can find the Client ID again later on the app’s Manage app page.
The developer portal banner shown after saving, with the Client ID and Client secret masked
6

Regenerate the client secret

If you lose the Client Secret, open the app’s Manage app page and click Regenerate client secret to generate a new one.

  • Regenerating the secret causes all token exchange and refresh attempts to fail until you update the connection with the new secret.
The Client secret section of the Manage app page with Regenerate client secret highlighted

​
Permissions

When you connect, StackOne requests the Clear Books permissions its actions need. You can narrow this set using the optional Scopes field in the StackOne Connector profile; leave it blank to request the full set below.

1

Grant the required permissions

Enables actions: Create Account Code, Create Allocation, Create Bank Account, Create Customer, Create Payment, Create Purchase Document, Create Sales Document, Create Supplier, Delete Account Code, Delete Allocation, Delete Bank Account, Delete Customer, Delete Payment, Delete Purchase Document, Delete Sales Document, Delete Supplier, Get Account Code, Get Allocation, Get Bank Account, Get Business, Get Customer, Get Payment, Get Purchase Document, Get Sales Document, Get Supplier, List Account Codes, List Allocations, List Bank Accounts, List Businesses, List Customers, List Payments, List Purchase Documents, List Sales Documents, List Suppliers, List VAT Rates, List VAT Treatments, Update Account Code, Update Bank Account, Update Business, Update Customer, Update Payment, Update Purchase Document, Update Sales Document, Update Supplier

Authorize the following permissions so the connector can read and write account codes, allocations, bank accounts, businesses, customers, payments, purchase documents, sales documents, suppliers, and VAT reference data.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Clear Books:
1

Open the connector

Log in to StackOne, open Connectors, and select Clear Books.
2

Choose actions and events

  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
3

Set up authentication

  • Select Authentication Type as OAuth 2.0.
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • Click Create Profile.
Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for Clear Books.