Create and test with a sandbox company
When you create your developer profile, you automatically get a sandbox company.
Sandbox companies are regionally-specific QuickBooks Online companies with sample data. They look and act just like a normal QuickBooks Online experience.
Use it as a testing environment during development to see your code in action. You can also connect them to external testing tools like Postman or Insomnia.
Note: Sandbox companies are for app development only. Intuit provides this environment, content, and sample data for non-commercial use and testing.
Create a sandbox company
- Sign in to your developer account.
- Select My Hub > Sandboxes from the upper-right corner of the toolbar.
- Select Add, located on the right.
- Select QuickBooks Online Plus or QuickBooks Online Advanced.
- If you select QuickBooks Online Plus, select a country from the Country dropdown. Note: Sandbox companies are region-specific. You can’t change this later on.
- Select Create.
You can create up to 10 sandbox companies. They’re valid and active for two years.
Tip: Each
QuickBooks Online SKU comes with specific features. We recommend you test with the one your users use the most. Develop your app for features the majority of your users have access to.
Test code with a sandbox company
There are a few ways to use your sandbox company:
- Sandboxes automatically connect to our testing tools, like the OAuth 2.0 Playground
- Connect them to third-party testing tools
Here’s what you’ll need to connect and use your sandbox company.
Get a sandbox’s credentials
- Sign in to your developer account.
- Select your app.
- Select Keys and credentials from the left navigation pane.
- Select Development and turn on Show Credentials.
- Retrieve or copy the Client ID and Client Secret.
Get the sandbox base URL
Use this base URL for sandbox companies: https://sandbox-quickbooks.api.intuit.com/v3
Open a sandbox company to see your code in action
- Sign in to your developer account.
- Select the name of the sandbox company.
Tip: You can’t open multiple sandboxes or QuickBooks Online companies in the same browser at once. Here are a few ways to
get around this.
Clear data and reset the sandbox
You can delete all sample data and anything else you’ve entered since you started. This deletes all the data, but keeps the sandbox company.
- Sign in to your developer account.
- Find the sandbox company on the list.
- Select Clear data and reset from the button in the Action column.
You can also completely delete a sandbox company if you no longer need it. To delete the sandbox entirely, select Delete entire sandbox from the button in the Action column.
Learn more about sandbox companies
For a deeper dive, check out the sandbox FAQ. You can also get connect with other developers on the Intuit Developer community forum.
If you need more help, or run into errors, reach out to our developer support team.