Besides the sandbox environment tied to your developer account, you can use Postman to test REST API production code and endpoints.
Already using Postman? Simply download a QuickBooks-specific collection and set up your testing environment. If you need testing tools, Postman may be a great option - and we’ve got everything you need to get up and running.
If you haven’t already, sign in to your developer account and create your app.
Download and install Postman.
Download one of the Postman collections. Collections give you sets of pre-built requests to test with. All collections use OAuth 2.0.
For QuickBooks Online Accounting API: Get a collection of individual resource endpoints | |
For QuickBooks Online Accounting: Get an orchestrated collection based around specific use cases | |
For Payments API: Get a collection of individual resource endpoints and an orchestrated collection based around specific use cases |
In Postman, go to the Collections menu any time to see the types of sample requests you can make.
Postman needs your app’s authorization keys to generate access tokens and connect to the QuickBooks Online API:
Before you leave the app also set the redirect URI:
Enter the following in each field as needed:
Data field | What to enter |
Token Name | A name for the token. Token names appear in the Existing Tokens list when you test requests. |
Grant Type | Select Authorization Code |
Callback URL | https://www.getpostman.com/oauth2/callback |
Auth URL | https://appcenter.intuit.com/connect/oauth2 |
Access Token URL | https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer |
Client ID and Client Secret | Enter your app’s Client ID and Client Secret. |
Scope | For the QuickBooks Online Accounting API: com.intuit.quickbooks.accounting For the QuickBooks Payments: com.intuit.quickbooks.payment |
State | You can enter any useful info about your app. The Intuit Authorization Server round trips this parameter. Your app gets the same value it requested back in the response. |
Client Authentication | Set to Send client credentials in body |
When you’re done, select Get new access token. You may need to sign in and connect your Intuit Developer Account to Postman.
The collections you downloaded give you environment templates. Add a few details about your sandbox test company:
Enter the following for each field as needed:
Data field | What to enter |
baseurl | For the QuickBooks Online Accounting API: sandbox-quickbooks.api.intuit.com For the QuickBooks Payments: sandbox.api.intuit.com |
companyid | Your sandbox test company’s company ID |
minorversion | The minor version for your app |
UserAgent | QBOV3-OAuth2-Postman-Collection |
Everything is ready to start testing. You should have an authorization token after you set up. Tokens are valid for 60 minutes.
You’ll see the server response in the Body tab.