Because QuickBooks Online is a cloud application, you don't need to give your user the Autofy Agent in order to connect. Instead, follow this guide to get your users on board. We'll discuss what to do in test, and in production. Follow all the test steps first before following the production steps.
Before you begin, you'll need to register your app with Intuit if you haven't already. Create a listing for your app with Intuit, then continue here.
1. Send your production Client ID and Client Secret to an Autofy developer.
Production ID and Secret
Autofy needs your production app's Client ID and Client Secret - developer apps aren't supported.
Please do not send Client ID and Client Secret for your customer's production account.
If you're having trouble figuring out what to send, please reach us using the messenger below, or email [email protected]
These are securely stored in our environment, and are used to enable the connection between Autofy and QuickBooks Online on behalf of your application. We'll give you an Autofy
appID, which will identify your app in Autofy.
Autofy doesn't support QBO sandbox companies. In order to test, set up a production trial of QBO, or use a subscription you already have.
2. Review our example page.
Go to this example page. Here you'll see a few fields we need to capture in order to enable the connection to QBO. You'll set these programmatically when you establish the connection in production.
channelis a short code that identifies which application you're connecting to. In this case, it will be 'qbo'.
appIDis the aforementioned ID that our development team issues to you, which identifies your application.
userIDis created in a further step. Use this to get an
endpointID, which identifies the QBO company you want to make requests against.
3. Create a User
https://api.getautofy.com/v2/manage/user from our Create A User guide to create a user. Store
user.id from the response, this is your
4. Connect to your test QBO from our example page
Fill in the values on the page and click Connect. This will connect Autofy to your QBO, and return
endpointID in a response displayed on our example page. Autofy is now connected to your QBO, and you can now make calls against it.
In production, you'll need a page or component on your website that achieves what the Test setup above does.
1. Import the Autofy js component.
afconnect.js. Import it from this location:
2. Create a div in your HTML that will contain the QB Connect button.
afconnect.js will place the button there.
3. Create your user just as above, with Create A User.
4. Programatically fill in
On your page, set these values in an object that we recommend calling
appID was given to you by Autofy.
userID was returned from /manage/user/. Recall that
channel will always be 'qbo'.
5. Receive the response from Autofy.
Once this is implemented, your end user will click Connect. When they do,
afconnect.js will respond with an object via message event. You should implement an eventListener to receive the response.
endpointID for use in API requests for the QBO company.
Updated over 2 years ago