Intuit Developer Setup Troubleshooting

This guide helps you resolve common issues when setting up your Intuit Developer account and QuickBooks app.

OAuth Configuration Issues

Redirect URI Format Errors

Problem: Getting errors about URI format.

Solutions:

✅ Correct format:


https://hubspot.structur.app/quickbooks/oauth-callback

❌ Common mistakes:


http://... (use HTTPS)
...oauth-callback/ (no trailing slash)
...oauth-callback? (no query parameters)

redirect_uri_mismatch Error

Problem: Getting “redirect_uri_mismatch” during OAuth flow.

Solutions:

Verify the URI in your app matches exactly what’s configured
Check for trailing slashes
Ensure HTTPS (not HTTP)
Verify case sensitivity (URIs are case-sensitive)
Check for extra spaces
Make sure you’re using the right environment (Dev vs Prod)

Credentials Issues

Cannot Find Client ID or Secret

Problem: Can’t locate your OAuth credentials.

Solutions:

Go to your app in My Apps
Navigate to Keys & credentials tab
Development keys are in the Development section
Production keys are in the Production section (if generated)
Client ID is always visible
Click Show to reveal Client Secret

Client Secret Not Showing

Problem: Cannot view the Client Secret.

Solutions:

Look for a Show button or eye icon next to the secret
Click the icon to reveal the secret
If button doesn’t work, try different browser
Clear browser cache
Make sure JavaScript is enabled

Production Keys Issues

Cannot Create Production Keys

Problem: Production keys section is disabled or unavailable.

Solutions:

You must provide required information first:
- Privacy Policy URL (must be publicly accessible)
- EULA URL (must be publicly accessible)
- App description
Verify URLs use HTTPS
Test that URLs load successfully
URLs cannot be localhost or internal domains
Complete all required fields before clicking Create

Privacy Policy URL Rejected

Problem: Your Privacy Policy URL is not accepted.

Solutions:

URL must be publicly accessible (not behind login)
Must use HTTPS protocol
Page must load successfully
Cannot be a PDF download link
Should be a dedicated privacy policy page
Check for typos in the URL

Connection and Testing Issues

Sandbox Company Not Appearing

Problem: Cannot find or connect to sandbox company.

Solutions:

Verify you’ve created a sandbox company:
- Go to developer.intuit.com
- Navigate to Sandbox section
- Click Create sandbox company
Make sure you’re using Development credentials
Environment must be set to “Sandbox”
Sign in to the correct Intuit account
Sandbox companies may take a minute to become available

Cannot Test OAuth Flow

Problem: OAuth authentication isn’t working during testing.

Solutions:

Verify redirect URI is configured correctly
Check that you’re using the right credentials (Dev vs Prod)
Make sure environment setting matches your keys
Clear browser cookies and try again
Check browser console for JavaScript errors
Verify your callback endpoint is working

App Management Issues

Cannot Delete App

Problem: Unable to delete an app you no longer need.

Solutions:

Go to My Apps
Click on the app
Look for Settings or Advanced tab
Find Delete app or Remove app option
Apps with active OAuth tokens may need tokens revoked first
Contact Intuit support if you cannot delete

App Disappeared from Dashboard

Problem: Your app is no longer visible in My Apps.

Solutions:

Verify you’re signed into the correct Intuit account
Check if app was accidentally deleted
Apps may be archived - look for “Show archived” option
Try different browser
Contact Intuit support to recover if needed

Browser and Technical Issues

Page Won’t Load

Problem: Developer Portal pages won’t load or display correctly.

Solutions:

Clear browser cache and cookies
Try a different browser
Disable browser extensions
Check internet connection
Try incognito/private mode
Check if firewall is blocking the site

Changes Not Saving

Problem: Your configuration changes aren’t being saved.

Solutions:

Wait for save confirmation message
Check for error messages
Try refreshing and re-entering changes
Different browser might work better
Check browser console for errors
Make sure you clicked the Save button

Getting Additional Help

If you’ve tried these solutions and still have issues:

Intuit Developer Support

Help Center: help.developer.intuit.com
Community Forums: Active developer community
Support Ticket: Submit a request through the help center
Documentation: developer.intuit.com/docs

Our Support

For issues specific to the HubSpot integration:

Email: support@structur.app
Phone: +1-800-555-5555
Documentation: See our Troubleshooting section

Before Contacting Support

Have this information ready:

Your Intuit Developer account email
App name or App ID
Environment (Sandbox or Production)
Specific error messages
Screenshots of the issue
Steps to reproduce the problem
Browser and version being used

Quick Reference

Common Error Codes

Error Code	Meaning	Solution
`redirect_uri_mismatch`	Redirect URI doesn’t match	Check URI configuration exactly matches
`invalid_client`	Client credentials invalid	Verify Client ID and Secret are correct
`unauthorized_client`	Client not authorized	Check scopes and OAuth configuration
`invalid_scope`	Requested scope not available	Verify Accounting scope is selected
`access_denied`	User denied authorization	User must approve OAuth request

Useful Links

What’s Next?

Once you’ve resolved your Intuit setup issues:

Continue setup: Configure QuickBooks connection in HubSpot
Install integration: Installation guide
Learn usage: Creating invoices guide