Skip to main content

Authorization

Follow this guide to create a new Intuit QuickBooks credential that will allow Nexla to authenticate to and exchange data with your QuickBooks account.
intuit_qb_api_auth.png

Intuit QuickBooks

Prerequisites​

Before creating an Intuit QuickBooks credential, you need to have a QuickBooks account. The credential uses the Nexla App for OAuth2 authentication, which simplifies the setup process by using a pre-configured OAuth2 application managed by Nexla.

To use this credential, you need to have a QuickBooks account. Once you have access to your account, you can connect it to Nexla using the OAuth2 authorization flow. The Nexla App handles the OAuth2 authentication process, so you do not need to create your own OAuth2 application. For detailed information about QuickBooks API authentication and setup, refer to the QuickBooks API documentation.

Create an Intuit QuickBooks Credential​

  • To create a new Intuit QuickBooks credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Intuit QuickBooks

IntuitQBCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

OAuth2 Authentication​

Intuit QuickBooks uses OAuth2 authentication to securely access the QuickBooks API. The credential uses the Nexla App for OAuth2 authentication, which simplifies the setup process by using a pre-configured OAuth2 application managed by Nexla.

  1. Click the Authorize button to begin the OAuth2 authorization flow. This will redirect you to Intuit's authorization page where you will be asked to sign in with your QuickBooks account and grant permissions to Nexla to access your QuickBooks data.

    During the OAuth2 authorization flow, you will be redirected to Intuit's authorization page. You must sign in with a QuickBooks account that has access to the QuickBooks company you want to connect. After signing in, you will be asked to grant permissions to Nexla to access your QuickBooks data. The access scopes determine what permissions are requested. Once you grant permissions, you will be redirected back to Nexla, and the authorization will be completed automatically.

  2. After completing the OAuth2 authorization flow, Nexla will automatically obtain and store the access token and refresh token needed to authenticate API requests. The access token is used to authenticate each API request, and the refresh token is used to obtain new access tokens when the current access token expires.

    OAuth2 access tokens expire after a certain period for security reasons. Nexla automatically refreshes expired access tokens using the refresh token, so you typically do not need to re-authorize unless you revoke access or the refresh token expires. The access token is sent in the Authorization header with the Bearer prefix for all API requests to the QuickBooks API. For detailed information about OAuth2 authentication, token management, and available scopes, see the QuickBooks API documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.