> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intuit

## Overview

<CardGroup cols={3}>
  <Card title="Pre-built tooling" icon="screwdriver-wrench" href="#pre-built-tooling" />

  <Card title="Pre-built integrations" icon="square-check" href="#pre-built-integrations" />

  <Card title="Access requirements" icon="triangle-exclamation" href="#access-requirements" />

  <Card title="Setup guide" icon="rocket" href="#setup-guide" />

  <Card title="Useful links" icon="circle-info" href="#useful-links" />

  <Card title="API gotchas" icon="biohazard" href="#api-gotchas" />
</CardGroup>

## Pre-built tooling

<AccordionGroup>
  <Accordion title="✅ Authorization">
    | Tools                           | Status |
    | ------------------------------- | ------ |
    | Pre-built authorization (OAuth) | ✅      |
    | Credentials auto-refresh        | ✅      |
    | Pre-built authorization UI      | ✅      |
    | Custom authorization UI         | ✅      |
    | Expired credentials detection   | ✅      |
  </Accordion>

  <Accordion title="✅ Read & write data">
    | Tools                                     | Status                         |
    | ----------------------------------------- | ------------------------------ |
    | Pre-built integrations                    | 🚫 (time to contribute: \<48h) |
    | API unification                           | ✅                              |
    | 2-way sync                                | ✅                              |
    | Webhooks from Nango on data modifications | ✅                              |
    | Real-time webhooks from 3rd-party API     | 🚫 (time to contribute: \<48h) |
    | Proxy requests                            | ✅                              |
  </Accordion>

  <Accordion title="✅ Observability & data quality">
    | Tools                   | Status |
    | ----------------------- | ------ |
    | HTTP request logging    | ✅      |
    | End-to-end type safety  | ✅      |
    | Data runtime validation | ✅      |
    | OpenTelemetry export    | ✅      |
    | Slack alerts on errors  | ✅      |
    | Integration status API  | ✅      |
  </Accordion>

  <Accordion title="✅ Customization">
    | Tools                              | Status                         |
    | ---------------------------------- | ------------------------------ |
    | Create or customize use-cases      | ✅                              |
    | Pre-configured pagination          | 🚫 (time to contribute: \<48h) |
    | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
    | Per-customer configurations        | ✅                              |
  </Accordion>
</AccordionGroup>

*No pre-built syncs or actions available yet.*

<Tip>Not seeing the integration you need? [Build your own](/guides/functions/functions-guide) independently.</Tip>

## Access requirements

| Pre-Requisites    | Status         | Comment                                                                                                   |
| ----------------- | -------------- | --------------------------------------------------------------------------------------------------------- |
| Paid dev account  | ✅ Not required | Free, self-signup for an [Intuit Developer account](https://developer.intuit.com/app/developer/homepage). |
| Paid test account | ✅ Not required | Free sandbox environment is available for testing.                                                        |
| Partnership       | ✅ Not required |                                                                                                           |
| App review        | ⚠️ Conditional | Required only if you want to list your app on the [QuickBooks App Store](https://apps.intuit.com/).       |
| Security audit    | ✅ Not required |                                                                                                           |

## Setup guide

<Steps>
  <Step title="Create your app on the Intuit Developer Portal">
    1. Sign up for an [Intuit Developer account](https://developer.intuit.com/app/developer/homepage) if you don't already have one.
    2. Sign in to your [developer account](https://developer.intuit.com/dashboard).
    3. Click on **Create an app** on the dashboard.
    4. Select **QuickBooks Online and Payments** as the API provider.
    5. Enter your app name and select the appropriate app type:
       * **Development**: For testing and development
       * **Production**: For live applications
    6. Click **Create app**.
  </Step>

  <Step title="Configure OAuth 2.0 settings">
    1. In your app's dashboard, navigate to the **Development** or **Production** section (depending on your environment).
    2. Select **Keys & OAuth** from the left navigation menu.
    3. Under **Redirect URIs**, click **Add URI**.
    4. Enter `https://api.nango.dev/oauth/callback` as the redirect URI.
    5. Click **Save**.
  </Step>

  <Step title="Select OAuth scopes">
    1. In the **Keys & OAuth** section, locate the **OAuth 2.0** area.
    2. Under **Select scopes**, choose the appropriate scopes for your integration:
       * **Accounting**: For access to QuickBooks Online accounting data
       * **Payments**: For access to payment processing features
       * **OpenID**: For user authentication (recommended)
       * **Profile**: For access to user profile information
       * **Email**: For access to user email information
       * **Phone**: For access to user phone information
       * **Address**: For access to user address information
    3. Click **Save** to update your scopes.
  </Step>

  <Step title="Obtain your client credentials">
    1. In the **Keys & OAuth** section, locate your **Client ID** and **Client Secret**.
    2. Copy these values as you'll need them when configuring your integration in Nango.

    Note: There are separate credentials for Development and Production environments. Make sure you're using the correct set for your intended environment.
  </Step>

  <Step title="Configure your integration in Nango">
    When setting up your Intuit integration in Nango:

    * Use your **Client ID** and **Client Secret** from the previous step
    * For the authorization URL, use: `https://appcenter.intuit.com/connect/oauth2`
    * For the token URL, use: `https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer`
  </Step>

  <Step title="Test the authorization flow">
    1. Use the [OAuth Playground](https://developer.intuit.com/app/developer/playground) to test your OAuth implementation.
    2. The OAuth Playground provides sample data and allows you to preview each step of the authorization flow.
    3. This step is optional but recommended to ensure your OAuth configuration is working correctly.
  </Step>

  <Step title="Next">
    Follow the [*Quickstart*](/getting-started/quickstart).
  </Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

## Useful links

* [Intuit Developer Portal](https://developer.intuit.com/app/developer/homepage)
* [Intuit Developer Dashboard](https://developer.intuit.com/dashboard)
* [OAuth 2.0 Documentation](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0)
* [OAuth Playground](https://developer.intuit.com/app/developer/playground)
* [OAuth Scopes](https://developer.intuit.com/app/developer/qbo/docs/learn/scopes)
* [Authorization Discovery Documents](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/discovery-document)
* [QuickBooks API Reference](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/account)
* [API Explorer](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/account)
* [API Rate Limits](https://developer.intuit.com/app/developer/qbo/docs/develop/troubleshooting/error-handling#rate-limiting)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/intuit.mdx)</Note>

## Common Scopes

For a complete list of available OAuth scopes, see the [Intuit OAuth Scopes documentation](https://developer.intuit.com/app/developer/qbo/docs/learn/scopes).

## API gotchas

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/intuit.mdx)</Note>
