Register an OAuth Application
Register an application in the Intuit Developer Portal to obtain OAuth credentials for API access.
Sign in to the Intuit Developer Portal
Sign in to your Intuit Developer account.
- Click Sign In in the top right corner.
- If you don’t have an account, click Create an account to register.
Create a new application
From the App dashboard, create a new application for QuickBooks Online.
- From the top right, click the My Hub dropdown and select App dashboard.
- Click the + box to create a new application.
- In the Create a new app dialog, select QuickBooks Online and Payments as the app type and click Next.
- Enter an Application name (e.g.,
StackOne Integration). - Select the required scope com.intuit.quickbooks.accounting and click Done.
- In the Add these permissions? confirmation popup, click Confirm to create the app.
Copy Client Credentials
After app creation, the Your app is ready for testing page displays your credentials.
- Toggle Show credentials to reveal the Client ID and Client Secret.
- Copy both values and store them securely for use later.
- These credentials can also be found later under Keys and credentials in the left sidebar.
Configure Redirect URI (Development)
Add the redirect URI for the Development environment. This is required for sandbox testing.
- Click Settings in the left sidebar.
- Select the Redirect URIs tab at the top of the page.
- Make sure you are on the Development section.
- Click Add URI.
- Enter
https://api.stackone.com/connect/oauth2/quickbooksonline/callback. - Click Save to apply the changes.
- Important: When you receive Production keys, repeat these steps under the Production section to add the same redirect URI for production use.
Sandbox Environment
Intuit provides separate environments for development and production. Development keys do not work with live QuickBooks accounts, and production keys do not work in the sandbox. Use the sandbox environment for development and testing.
- API Base URL:
https://sandbox-quickbooks.api.intuit.com - Use Development keys from Keys and credentials.
Create a Sandbox Company
Create a sandbox company to test your integration with sample data.
- Sign in to the Intuit Developer Portal.
- Click the My Hub dropdown in the top right and select Sandbox.
- Click the Add button on the right.
- In the Create a sandbox company dialog, select a country from the Country dropdown.
- Under the QuickBooks Online SKU section, choose QuickBooks Online Plus or QuickBooks Online Advanced.
- Alternatively, under the Intuit Enterprise Suite SKU section, choose Single Entity or Multi-Entity.
- Click Create to create the sandbox company.
- You can create up to 10 sandbox companies. Each is valid for two years.
- Sandbox companies are region-specific and cannot be changed after creation.
- No real financial data is processed.
Production Environment
Production access requires completing two sections — App details and Compliance — before Intuit unlocks your production credentials. Click Keys and credentials in the left sidebar, then select the Production tab.
Complete App details
Complete the App details section on the Production tab.
- Add your app’s end-user license agreement and privacy policy URLs.
- Add your app’s host domain, launch URL, disconnect URL, and connect/reconnect URL.
- Select at least one category for your app.
Complete Compliance
Complete the Compliance section on the same page. This includes profile verification, regulated industries, hosting details, and an app assessment questionnaire.
- Review your Intuit Developer Portal profile and verify your email.
- Confirm your regulated industries on the settings page.
- Tell Intuit where your app is hosted.
Complete the App assessment questionnaire
Complete the App assessment questionnaire within the Compliance section. This questionnaire covers your app’s features, supported users, and platform compliance.
- Click Continue questionnaire to start or resume.
- The questionnaire takes approximately 30 minutes to complete.
- You can save your progress and return later if needed.
- Once submitted, Intuit will review your responses.
Receive Production keys
After completing both sections and passing the questionnaire review, Intuit will unlock your production credentials.
- Intuit will review your responses to ensure compliance with their guidelines.
- Once approved, Production Client ID and Client Secret become available on the page.
- Production API Base URL:
https://quickbooks.api.intuit.com - Production keys are required to connect live QuickBooks companies (not sandbox).
Configuring Scopes (Optional)
Customize the OAuth scopes based on your integration needs.
Select scopes
QuickBooks Online uses the following scopes for API access. Select the scopes your integration requires.
Creating the StackOne Connector Profile
To create the Connector Profile in StackOne for QuickBooks Online:Navigate to Connector Profiles
Create New Connector Profile
- Click + Connector Profile
- Search for and select QuickBooks Online
- 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