quickbooks-auth

Manage OAuth tokens and authentication for QuickBooks connections.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/ticruz38/skills --skill quickbooks-auth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: quickbooks-auth
Source: https://github.com/ticruz38/skills/tree/main/skills/quickbooks-auth
Command: npx skills add https://github.com/ticruz38/skills --skill quickbooks-auth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QuickBooks integration with OAuth can be complex, requiring secure token storage, automatic refresh, and multi-profile management; this skill provides a ready-to-use adapter built on the auth-provider, handling the heavy lifting.

Core Features & Use Cases

  • Multi-Profile support for managing multiple QuickBooks company connections from a single user.
  • Sandbox/Production toggle to safely develop and deploy with real data separation.
  • Automatic token refresh, health checks, and Realm ID management to keep connections healthy.
  • Simplified API client with environment-aware base URL and fetch helper for QuickBooks endpoints. Use cases include onboarding multiple clients, maintaining persistent connections, and performing read/write operations against company data (invoices, customers, etc.) with a single cohesive interface.

Quick Start

Initiate the OAuth flow for a profile and complete it using the CLI.

Frequently Asked Questions about quickbooks-auth

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage QuickBooks OAuth tokens for multiple company profiles?▼

QuickBooks OAuth token management for multiple profiles is handled through an auth-provider adapter that stores tokens, tracks Realm IDs, and isolates connections per company profile.

How do I handle QuickBooks API authentication across sandbox and production environments?▼

QuickBooks API authentication across sandbox and production uses an environment-aware base URL toggle, allowing safe development and deployment with real data separation within the same client.

Can I automatically refresh expired QuickBooks OAuth tokens?▼

Yes, expired QuickBooks OAuth tokens are automatically refreshed using the TypeScript/JavaScript auth-provider adapter, ensuring persistent connections without manual re-authentication.

What's the best way to run health checks on QuickBooks API connections?▼

Running health checks on QuickBooks API connections is built into the authentication adapter, which verifies token validity and connection status before executing read or write operations.

How do I make authenticated fetch requests to the QuickBooks API?▼

Authenticated fetch requests to the QuickBooks API are executed via a built-in fetch helper that attaches valid OAuth tokens automatically for operations like reading invoices or managing customers.

Do I need an auth-provider to use QuickBooks OAuth integration?▼

Yes, an auth-provider is required as the foundational dependency, because the QuickBooks OAuth integration stores tokens and manages automatic refresh cycles directly through this interface.