Connector Center

QuickBooks

Manual setup, diagnostics, assets, freshness, and governance restrictions. Browser authorization buttons are intentionally not exposed in this workflow.

Manage Export Diagnostics JSON

Overview

QuickBooks

Company info / Invoices read later / P&L sync later

Status

not configured

Connected Account

None

Auth Mode

oauth

Manual Setup

Credentials and source notes

QuickBooks requires exact sandbox/production redirect URI setup. Production redirect URIs must be HTTPS and cannot be IP addresses.

Provider docs

Account Label

Auth Mode

oauth

Copy Redirect URI

https://your-project-name.vercel.app/api/integrations/quickbooks/callback

Exact Scopes Requested

com.intuit.quickbooks.accounting

Decode Last Setup State

Client ID is required before authorization.
Client secret is required before authorization.
Environment is required before authorization.
Scopes is required before authorization.

Production redirect URIs must be HTTPS, not IP addresses, and must match Intuit exactly including trailing slash.

Manual Token / API Key

Use this for personal access tokens, Admin API tokens, webhook secrets, and base IDs. Secret values are never shown again after save.

OAuth App Setup

Use this only for provider OAuth apps such as Google. If these values are in Vercel env vars, they are already durable.

Client IDClient secretSandbox redirect URIProduction redirect URIScopes

Additional Setup Notes

EnvironmentRealm ID

Operator Notes

Setup Checklist

Create/open the Intuit app.
Add the exact Luzione callback URL to the correct environment.
Save client credentials and environment.
Authorize with a user who can access the QuickBooks company.

Assets

Choose Assets is disabled until the provider is connected and asset listing is supported.

Required Environment

QUICKBOOKS_CLIENT_IDQUICKBOOKS_CLIENT_SECRETQUICKBOOKS_REDIRECT_URI

Diagnostics

{
  "provider_key": "quickbooks",
  "status": "not_configured",
  "required_env_present": false,
  "missing_env_vars": [
    "QUICKBOOKS_CLIENT_ID",
    "QUICKBOOKS_CLIENT_SECRET",
    "QUICKBOOKS_REDIRECT_URI"
  ],
  "provider_setup_complete": false,
  "missing_setup_fields": [
    "clientId",
    "clientSecret",
    "environment",
    "scopes"
  ],
  "missing_setup_labels": [
    "Client ID",
    "Client secret",
    "Environment",
    "Scopes"
  ],
  "setup_warnings": [
    "Production redirect URIs must be HTTPS, not IP addresses, and must match Intuit exactly including trailing slash."
  ],
  "redirect_uri_expected": "https://your-project-name.vercel.app/api/integrations/quickbooks/callback",
  "callback_route": "/api/integrations/quickbooks/callback",
  "scopes": [
    "com.intuit.quickbooks.accounting"
  ],
  "token_present": false,
  "token_expiry": null,
  "last_test_status": null,
  "last_test_error": null,
  "decoded_last_error": null,
  "app_review_required": false,
  "setup_steps": [
    "Create/open the Intuit app.",
    "Add the exact Luzione callback URL to the correct environment.",
    "Save client credentials and environment.",
    "Authorize with a user who can access the QuickBooks company."
  ],
  "assets_supported": true,
  "assets_selected": false,
  "governed_usage_allowed": true,
  "external_actions_enabled": false
}