Configure app settings

The Settings tab lets you customize all aspects of the app, including the name, image, and various URLs necessary for obtaining your production keys and releasing the app. Modify these settings prior to attempting to publish your app and click save when finished.

About your app

  • App Icon: Click the icon box to upload a new image. This will be the icon used for your app on the QuickBooks app store.
  • APIs: Check these boxes to specify the APIs your app uses.
  • App Name: A descriptive name that helps users understand what your app does.
  • Permalink: Enter a string to customize your app's URL on the QuickBooks app store. For example, entering "AccountingApp" sets your app listing's URL to https://apps.intuit.com/AccountingApp.
  • Countries you accept connections from: Select countries where businesses will use your app. For each country you select, your integration with QuickBooks must meet local tax, currency, language, and other requirements.  More on reaching multiple countries
    Note: Your app may accept connections from anywhere in the world; these checkboxes simply specify which regional QuickBooks App Stores your app will be displayed in.

Intuit Single Sign-On settings

These settings impact how your app interacts with the QuickBooks app store and how users sign into your app. Refer to the section below that corresponds to your app's authentication model.

  • Intuit Single Sign-On?: Specify whether your app uses Intuit Single Sign-On. If not, you must provide a URL that users can click to learn more details about your app (see Learn more URL below).

For apps using Intuit Single Sign-On

  • OpenID URL: For apps that implement OAuth 1.0a, use this field to configure your OpenID URL for development and production environments. Intuit's OpenID 1.0a service redirects to this URL and passes it the OpenID identity of the user. Upon completion of the OAuth 1.0a workflow, the user is redirected to your app's dashboard, fully connected to the QuickBooks company.
  • Connect Request URI: For apps that implement OAuth 2.0, the location in your app to which users are directed upon clicking the Get App Now button. This location initiates the OAuth 2.0 workflow. Upon completion of the OAuth 2.0 workflow, the user is redirected to your app's dashboard, fully connected to the QuickBooks company.
  • Host Domain: Your app site domain name. Since your production environment may be different than your development environment, you must provide URLs for both.
  • Launch URL: The target for the app's Launch link where it appears in authorized app lists. This is your app's dashboard and, for apps planning to publish on the QuickBooks app store, the page that implements single sign-on.
  • Disconnect URL: The target for the app's Disconnect link. Your user lands on this page after the app disconnects from your user's QuickBooks company. Implement the Connect to QuickBooks button and single sign-on on this page so users can reconnect immediately. When a customer disconnects, Intuit passes your app an OpenID assertion about the user that just disconnected from your app. You can use that assertion to look up the user and mark them as disconnected or send them a message.

For apps not using Intuit Single Sign-On

When you have selected No for the Intuit Single Sign-On field, these options will be available.

  • Learn more URL: This is the URL that the Learn More button uses. It redirects users to this link; ideally, the link should contain more information about your app, including pricing, demo/trial information (if available), and details on how to get or install the app. This page should also discuss how the app is used and how it integrates with QuickBooks.
  • Host Domain: Your app site domain name. Since your production environment may be different than your development environment, you must provide URLs for both.
  • Launch URL: The launch URL should be set to your app’s login page.
  • Disconnect URL: The Disconnect URL should be a static page which informs the user that their QuickBooks connection has been terminated and provide instructions on how to reconnect to QuickBooks from within your app.

Terms of service

You must provide URLs for your app's EULA and Privacy Policy before you can get production keys.

  • End User License Agreement URL: The URL to your end user license agreement for your users.
  • Privacy Policy URL: The URL to your policy telling users how your app uses their data.​

Did you find this page helpful?
Your feedback helps us make our docs better. Please let us know if this page helped you, or if it needs improvement.

 Got Questions? Get Answers in our developer forums.