Sandboxes

Your Intuit Developer account comes automatically provisioned with a private US sandbox environment for testing your app's features and integration.  You can have up to four additional sandboxes distributed as you like across the Australia (AU), Canada (CA), France (FR), India (IN), United Kingdom (UK),  and US development regions.

Topics covered on this page:

In addition, see Sandbox FAQ's.

Note

Choose your sandbox allocation wisely. Once you have created a sandbox, you cannot delete it or change its country designation. 

QuickBooks Online sandbox overview

To help you build and test integration with QuickBooks, we provide you with a QuickBooks Online sandbox. It looks and acts just like your customers' live QuickBooks companies do.

Sandbox data sets

Each sandbox includes the following data to help you hit the ground running:

USAUCA

Construction Trade

  • 141 transactions
  • 31 customers
  • 26 vendors
  • 4 employees
  • 20 items
  • 90 accounts

Party Planning Services

  • 163 transactions
  • 30 customers
  • 38 vendors
  • 0 employees
  • 19 items
  • 102 accounts

Party Planning Services

  • 173 transactions
  • 29 customers
  • 37 vendors
  • 0 employees
  • 21 items
  • 95 accounts
INUKFR

Party Planning Services

  • 146 transactions
  • 29 customers
  • 37 vendors
  • 0 employees
  • 18 items
  • 51 accounts

Party Planning Services

  • 164 transactions
  • 32 customers
  • 35 vendors
  • 0 employees
  • 20 items
  • 80 accounts

Manufacturing Business

  • 31 transactions
  • 12 customers
  • 3 vendors
  • 2 employees
  • 15 items
  • 118 accounts

Your sandbox accounts are valid for life, but an individual test company for your use in the sandbox is valid for 2 years.

Payments

When you first sign up for an Intuit Developer account, we create your payment test account ready for use in testing Payments API calls. Currently, there's no sandbox site for the Merchant Service Center, where live users can find transaction reports and payment account settings. 

Note

Payments supported with U.S. QuickBooks Online sandbox companies, only.

Payroll

Payroll features are not yet supported.

Non-U.S. QuickBooks Online accounts

Currently, your sandbox supports Australian (AU), Canada (CA), France (FR), India (IN), and United Kingdom (UK), and United States (US) QuickBooks Online companies. In the meantime, if you want to release your app in other countries, it's easy to get additional country-specific accounts for testing. Read how to go global

Manage QuickBooks Online sandboxes

Launch a sandbox

Once logged in to Intuit Developer, select Sandbox from the  Docs & Tools landing page or from the dropdown arrow next to your name. The Manage Sandboxes page displays. To open a QuickBooks Online sandbox, click Go to company for the desired sandbox. Sign in with your developer credentials. 

Tip:

You are not able to use the same browser to simultaneously open multiple QuickBooks Online sandboxes, live production accounts, or a combination of the two. Additionally for a given browser and regardless of which one you select, your sandbox environment is defaulted to the last sandbox opened or, if none has been opened, the last sandbox on the list. Here are some ways you can have have multiple environments open at the same time or switch environments as needed:

  • Sign out of one, or use different browsers, like Chrome for your sandbox and Firefox for the production account.
  • Use your browser's private or incognito mode to work in these multiple environments simultaneously. 
  • Switch companies directly from  the QuickBooks Online UI via Gear Icon -> Switch Icon.

Create a sandbox

Create a sandbox from your total allocation via the Manage Sandboxes page. Once logged in to Intuit Developer, click either the Tools dropdown or the dropdown arrow next to your name from the menu on any page and choose Sandbox. The Manage Sandboxes page displays. Next, select the country and the click Add from the Manage Sandboxes page.

  • A US sandbox is provisioned automatically. You can have up to four additional sandboxes distributed as you like across the AU, CA, FR, IA, UK, and US development regions.
  • Once a sandbox is created, you cannot change its country designation.
  • A sandbox cannot be deleted.
  • Once your allocation is exhausted, the Add button is disabled.

Delete sandbox data

Delete the dataset for a sandbox via the Manage Sandboxes page.  Once logged in to Intuit Developer, click either the Tools dropdown or the dropdown arrow next to your name from the menu on any page and choose Sandbox. The Manage Sandboxes page displays. Next, click the dropdown arrow next to Go to company for the target sandbox and click Delete all data.

The following confirmation message displays:

6.0_DeleteSandboxConfirm.png

Click Yes to proceed with the delete operation. 

Note

This action deletes all data objects for the target company, both originally supplied when the sandbox is first created and objects subsequently created via the UI or via the QuickBooks Online API.

Making API calls to a sandbox company

  • Sandbox base URL to use with calls to the Accounting API:  https://sandbox-quickbooks.api.intuit.com/v3
  • Sandbox base URL to use with calls to the Payments API:  https://sandbox.api.intuit.com

Sandbox help

To get the most out of your sandbox, find tips and answers to common questions in our community forum and SandBox FAQs.If you're stumped or suspect something's not working right, contact our team.

Note

Use your sandbox only for app development. Intuit provides this environment, content, and sample data for non-commercial use and testing only. See terms of use.

 Got Questions? Get Answers in our developer forums.