Set up your Intuit app
QuickBooks for Voyant connects through an Intuit app that you own. You create it once in the Intuit Developer portal and paste its keys into the app's Settings in Voyant. It takes about 15 minutes.
Before you start
- Install QuickBooks by Voyant Labs from Apps in your Voyant admin, and open its Settings. Settings shows the redirect URI and your webhook URL, ready to copy.
- Have the sign-in of a QuickBooks Online company in the United States or the United Kingdom, as an admin.
1. Create the app
- Sign in at developer.intuit.com with your Intuit account and create an app from the dashboard.
- Choose QuickBooks Online and Payments, give the app a name you will recognise (for example Voyant), and select only the Accounting scope (com.intuit.quickbooks.accounting).
2. Get the production keys
Open the app's production keys and credentials. Intuit asks for the app's details first; enter these:
- Host domain: quickbooks.apps.voyant.travel
- Launch URL: https://quickbooks.apps.voyant.travel/
- Connect/Reconnect URL: https://quickbooks.apps.voyant.travel/connect
- Disconnect URL: https://quickbooks.apps.voyant.travel/disconnect
- End-user license agreement: https://quickbooks.apps.voyant.travel/terms
- Privacy policy: https://quickbooks.apps.voyant.travel/privacy
- Redirect URI: https://quickbooks.apps.voyant.travel/v1/quickbooks/oauth/callback
Intuit also asks a short questionnaire about the app. It is an app your company uses to connect its own QuickBooks company to Voyant. Questions about how the integration stores and protects data are answered in the privacy policy.
When Intuit shows the production Client ID and Client Secret, keep the page open for step 4.
3. Turn on webhooks
Webhooks bring changes made in QuickBooks, such as a payment recorded there, back to Voyant within minutes. Without them those changes arrive once a day.
- In the app's production webhooks, enter the webhook URL shown in the app's Settings in Voyant. It ends with your installation's identifier.
- Subscribe to Invoice, Estimate, Payment and Customer events.
- Copy the Verifier Token Intuit shows for the webhooks.
4. Save the keys in Voyant
- In your Voyant admin, open Apps, then QuickBooks.
- Under Intuit app, paste the Client ID, the Client Secret and the webhook Verifier Token, then save. They are stored encrypted and are never shown again.
- Choose Connect to QuickBooks, sign in to Intuit and choose your company.
To use a new Client Secret later, paste it in Settings at any time. To switch to a different Intuit app, disconnect QuickBooks first.
Need help
Contact Voyant support at voyant.travel/help. Never send your Client Secret or Verifier Token by email or chat.