QuickBooks Online Setup
The superglue agent reads and writes QuickBooks Online data through the QuickBooks Online Accounting API, for example accounts, customers, vendors, items, invoices, bills, payments, journal entries and reports. For live companies, superglue provides a managed Intuit sign-in app, so you do not have to create an app. You sign in with an Intuit account that has access to the client’s company.
This guide covers live companies and QuickBooks sandbox companies. For QuickBooks Desktop, see QuickBooks Desktop files.
What to expect
Section titled “What to expect”- Runs as the signed-in user. All calls run as the Intuit user who signs in.
- One company per connection. During sign-in, you select the company. superglue saves its company ID as the
realmIdsecret of the connection. - Reads without approval. Queries only read data and need no approval. Every other request, such as creating an invoice or a vendor, needs your approval in the default Ask for permission mode.
What you need from the client
Section titled “What you need from the client”- An Intuit user with access to the company. The agent can only see and change what this user can access.
- Which company. Live company or sandbox company. They need different connections.
- For a sandbox company only: access to the Intuit developer account that holds the sandbox company, and an app with Development credentials in that account. See Connect a sandbox company.
Set up QuickBooks Online
Section titled “Set up QuickBooks Online”-
Ask the agent to connect QuickBooks Online
- Start a session from the task, or click New session.
- Tell the agent what you need, for example: “Connect the client’s QuickBooks Online company.”
-
Sign in with Intuit
- The agent shows a connection card. Click the sign-in button on the card.
- In the Intuit sign-in window, sign in with the account that has access to the company.
- Select the company and approve the connection.
-
Test the connection
- Tell the agent: “Show me five customers from QuickBooks Online.” This request only reads data.
- If you get the customers back, the connection works.
The sign-in requests the scope com.intuit.quickbooks.accounting.
Connect a sandbox company
Section titled “Connect a sandbox company”The managed app works only with live companies. A sandbox company needs the QuickBooks Sandbox connection and an Intuit app with Development credentials. The recommended way is to let the agent create the app.
-
Let the agent create the app
- Tell the agent: “Connect our QuickBooks sandbox company.”
- Pick Do it in the browser. The agent asks for permission to use the browser.
- The agent opens the Intuit developer portal in its browser, in the side panel. Sign in yourself when the agent asks. If Intuit asks for a verification code, enter it in the browser. You can open the browser in full screen to do this.
- The agent creates the app, adds the redirect URI to the Development redirect URIs, and saves the Development client ID and client secret to the connection itself. You do not copy the values.
- Sign in on the connection card and select the sandbox company.
-
Or create the app yourself
- In the Intuit developer portal, create an app with the QuickBooks Online Accounting scope.
- Add the redirect URI to the app’s Development redirect URIs. Copy the exact redirect URI from the connection card in superglue. On superglue Cloud, it is
https://app.superglue.cloud/api/auth/callback. - Copy the app’s Development client ID and client secret.
- Tell the agent that you have the credentials, and enter both values in the connection card. Do not paste them into the chat.
- Sign in and select the sandbox company.
-
Test the connection
- Tell the agent: “Show me five customers from the QuickBooks sandbox.” If you get the customers back, the connection works.
Limits
Section titled “Limits”- Live or sandbox. The QuickBooks Online connection works only with live companies. The QuickBooks Sandbox connection works only with sandbox companies.
- Accounting scope only. The connection requests the Accounting scope. Payments or Payroll scopes can make the sign-in fail with an error such as
access_deniedwhen the app or the company does not have them. - Older connections. A connection from before superglue saved the company ID has no
realmId. Sign in again to add it.
Remove access
Section titled “Remove access”- In superglue, open Connections, open the menu of the QuickBooks connection, and click Delete. This deletes the saved sign-in. It cannot be undone.
- To remove access on the client side, the client can disconnect the app in QuickBooks Online.
Do I need to create an Intuit app?
Section titled “Do I need to create an Intuit app?”Not for a live company. superglue provides a managed Intuit app, and you only sign in. You need your own app only for a sandbox company.
How do I connect several companies?
Section titled “How do I connect several companies?”Add one connection for each company, and put the company in the connection name, for example “Northwind QBO” or “Northwind QBO sandbox”. Tell the agent which connection to use.
Does the agent change data during the test?
Section titled “Does the agent change data during the test?”No. The test runs a query, which only reads data. Queries need no approval.