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.
Note
Important: You can only create sandboxes for the Payments API in the US.
Currently, you can’t create sandbox environments for the Merchant Service Center.
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 the API Docs & Tools tab.
- Select Add a sandbox company.
- 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 Add.
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 and go to the Development section to get your Client ID and Client Secret.
Get the sandbox base URL
Use this base URL for sandbox companies: **https://sandbox.api.intuit.com **
Open a sandbox company to see your code in action
- Sign in to your developer account.
- Select the API Docs & Tools tab.
- Select Sandbox.
- 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.
Delete data from a sandbox company
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.
- Select the API Docs & Tools tab.
- Select Sandbox.
- Find the sandbox company on the list.
- In the Action column, select Delete all data from the dropdown.
You can also completely delete sandbox companies if you no longer need them. To delete the sandbox entirely, select Delete sandbox from the dropdown instead.
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.