Uninstall Overview

This section guides you through disconnecting from QuickBooks and uninstalling the QuickBooks Invoicing integration from your HubSpot account. It’s important to understand the difference between disconnecting and uninstalling, and what happens to your data in each case.

Disconnect vs Uninstall

There are two ways to stop using the QuickBooks integration:

Disconnect from QuickBooks

What it does:

• Removes the OAuth connection between HubSpot and QuickBooks
• Stops the integration from creating new invoices
• Removes your stored QuickBooks credentials

What it keeps:

• The HubSpot app remains installed
• CRM card stays visible on deal records
• Settings page remains accessible
• You can reconnect to QuickBooks anytime

When to use:

• Temporarily stop using the integration
• Switch between Sandbox and Production environments
• Disconnect from one QuickBooks company to connect to another
• Rotate OAuth credentials for security

Uninstall from HubSpot

What it does:

• Removes the app from HubSpot completely
• Disconnects from QuickBooks (if connected)
• Removes CRM card from deal records
• Removes settings page

What it keeps:

• Invoices created in QuickBooks (remain in QuickBooks)
• Customer data in QuickBooks (not deleted)
• QuickBooks company data (unaffected)

When to use:

• Permanently stop using the integration
• Remove all traces of the app from HubSpot
• Switch to a different invoicing solution
• Clean up unused integrations

Quick Navigation

Choose your path based on your needs:

Just Want to Disconnect QuickBooks?

Disconnect QuickBooks - Remove OAuth connection while keeping the app installed

Need to Completely Remove the App?

Data Impact Warning - Read this FIRST to understand what happens to your data

Then proceed to uninstall following the instructions in the Data Impact page.

Want to Reinstall Later?

Reinstallation Guide - How to reinstall and reconnect after uninstalling

Important Considerations

Warning: Before disconnecting or uninstalling, review these important points:

Data Retention

• QuickBooks data is permanent: Invoices and customers created in QuickBooks are NOT deleted
• HubSpot data is unchanged: Your deals, contacts, and other HubSpot records remain intact
• No automatic cleanup: You must manually delete invoices or customers in QuickBooks if needed

Access to QuickBooks

After disconnecting or uninstalling:

• You can still access invoices in QuickBooks directly
• Customers created by the integration remain in QuickBooks
• Invoice history is preserved in QuickBooks
• You can manually manage all data in QuickBooks

Reconnection

• Disconnect: Reconnect anytime by entering credentials in Settings
• Uninstall: Requires reinstalling from HubSpot Marketplace, then reconnecting

Impact on Workflows

If you’ve built workflows or processes around this integration:

• CRM card data will no longer update
• Invoice creation from HubSpot will stop
• Email scheduling features won’t work
• Customer sync will cease

What Happens to Your Data?

Understanding data impact is critical before proceeding. Here’s a summary:

Critical: Read the Data Impact page for comprehensive details about what happens to each type of data.

Common Uninstall Scenarios

Scenario 1: Testing to Production

Situation: You tested with Sandbox and now want to use Production

Solution:

1. Disconnect from Sandbox
2. Switch environment to Production in Settings
3. Enter Production credentials
4. Connect to production QuickBooks company

No uninstall needed!

Scenario 2: Switching QuickBooks Companies

Situation: You want to connect to a different QuickBooks company

Solution:

1. Disconnect from current company
2. Reconnect and select the new company during OAuth

No uninstall needed!

Scenario 3: Stopping Use Completely

Situation: You no longer need the integration at all

Solution:

1. Review Data Impact carefully
2. Decide what to do with QuickBooks data (invoices, customers)
3. Disconnect from QuickBooks
4. Uninstall from HubSpot (instructions in Data Impact page)

Scenario 4: Security Credential Rotation

Situation: You need to rotate OAuth credentials for security

Solution:

1. Disconnect from QuickBooks
2. Rotate credentials in Intuit Developer Portal
3. Update credentials in HubSpot settings
4. Reconnect to QuickBooks

No uninstall needed!

Before You Proceed

Stop and Read: Before disconnecting or uninstalling, complete this checklist:

• I understand the difference between disconnect and uninstall
• I’ve read the Data Impact page
• I know what will happen to invoices in QuickBooks
• I know what will happen to customers in QuickBooks
• I’ve decided whether to manually clean up QuickBooks data
• I’ve communicated with my team about the disconnection/uninstall
• I have a backup plan if I need to reconnect
• I understand that OAuth tokens will be permanently deleted

Step-by-Step Guides

For Disconnecting Only

Follow this guide to remove the QuickBooks connection while keeping the app:

Disconnect QuickBooks Guide

For Complete Uninstall

Read the data impact warning first, then follow uninstall instructions:

1. Data Impact - READ FIRST ⚠️ CRITICAL
2. Follow uninstall instructions at the end of the Data Impact page

For Reinstalling Later

If you uninstall and want to reinstall:

Reinstallation Guide

Getting Help

If you’re considering disconnecting or uninstalling due to issues:

Before You Disconnect

Try these troubleshooting resources first:

• Authentication Issues
• Invoice Creation Issues
• Email Sending Issues
• General Troubleshooting

Contact Support

We’re here to help resolve issues:

• Email: support@structur.app
• Phone: +1-800-555-5555
• Response Time: Within 24 hours on business days

Many issues can be resolved without disconnecting or uninstalling.

What’s Next?

Choose your path:

1. Disconnect QuickBooks - Temporary disconnection
2. Data Impact Warning - Before permanent uninstall
3. Reinstallation - If you’ve already uninstalled

Additional Resources

• HubSpot Connected Apps Management 
• Intuit OAuth Token Management 
• QuickBooks Data Management