Data Impact Warning

⚠️ IMPORTANT: Uninstalling removes the integration from HubSpot. Review this guide carefully before proceeding.

Critical Information: Read this page completely before uninstalling the QuickBooks Invoicing integration. Understanding what happens to your data is essential for making an informed decision.

Overview

When you uninstall the QuickBooks Invoicing integration from HubSpot, several things happen to your data. This page explains exactly what is deleted, what is preserved, and what you need to know before proceeding.

Executive Summary

What is DELETED:

❌ OAuth access and refresh tokens (QuickBooks connection)
❌ Encrypted Client ID and Client Secret
❌ Default settings (tax codes, products)
❌ QuickBooks Invoices CRM card from deal records
❌ Settings page and configuration interface

What is PRESERVED:

✅ All invoices in QuickBooks (permanent)
✅ All customers in QuickBooks (permanent)
✅ All HubSpot deals (unchanged)
✅ All HubSpot contacts (unchanged)
✅ All HubSpot quotes and line items (unchanged)

CRITICAL: Your business data in both HubSpot and QuickBooks remains completely intact. Only the integration configuration and connection are removed.

Your Data Privacy is Protected

We Cannot Access Your Data After Token Deletion

Privacy Guarantee: Once you disconnect or uninstall, we lose all ability to access your QuickBooks data. Here’s why:

How OAuth Token Security Works:

Tokens are the ONLY access method: OAuth access tokens and refresh tokens are the sole means by which the integration can read or write data in QuickBooks. Without these tokens, API calls to QuickBooks are impossible.
Tokens are deleted immediately: When you disconnect or uninstall, your OAuth tokens are permanently deleted from our database within seconds. There is no backup, no archive, and no recovery mechanism.
Encrypted storage cannot be accessed: Your tokens are encrypted using a derived key specific to your HubSpot account. Even if database backups exist, the encrypted tokens are useless without:
- Your active account credentials
- The active encryption key (which is rotated when you disconnect)
- An active OAuth session
No alternative access paths: The integration does not store your Intuit username/password, does not have access to your QuickBooks account outside of the OAuth token, and cannot use your Client ID/Secret to access data (they only initiate new OAuth flows, which require user consent).

What This Means for You:

✅ Your QuickBooks data is immediately inaccessible to our application after token deletion
✅ We cannot read your invoices, customers, or financial data after disconnection
✅ We cannot create, modify, or delete anything in QuickBooks after disconnection
✅ Your QuickBooks account is completely private once disconnected
✅ No background processes can access your data after uninstall

Technical Guarantee:


Token Deleted → API Access Impossible → Complete Data Privacy

Even our developers cannot access your QuickBooks data after you disconnect, even if they wanted to. The OAuth architecture ensures complete data isolation.

Detailed Data Impact

1. QuickBooks Data (Preserved)

Invoices:

✅ All invoices created by the integration remain in QuickBooks
✅ Invoice numbers, amounts, line items preserved
✅ Customer associations intact
✅ Payment status unchanged
✅ Email history in QuickBooks preserved

Action Required: None. Invoices remain accessible in QuickBooks indefinitely.

If you want to delete invoices:

Log into QuickBooks Online
Navigate to Sales → Invoices
Manually delete invoices if needed
Consider voiding instead of deleting for accounting records

Customers:

✅ All customers created by the integration remain in QuickBooks
✅ Customer names, emails, addresses preserved
✅ Customer associations to invoices intact
✅ Customer can still be used for other invoices

Action Required: None. Customers remain in QuickBooks.

If you want to delete customers:

Log into QuickBooks Online
Navigate to Sales → Customers
Make customer Inactive (recommended) or Delete
Note: Cannot delete customers with associated transactions

Products and Tax Codes:

✅ Products in QuickBooks are unaffected
✅ Tax codes in QuickBooks are unaffected
✅ These were only referenced, not created by the integration

Action Required: None.

2. HubSpot Data (Preserved)

Deals:

✅ All deal records remain unchanged
✅ Deal amounts, stages, properties preserved
✅ Deal associations (contacts, companies) intact
✅ Custom properties unaffected

Action Required: None. Your HubSpot deals are completely unaffected.

Contacts:

✅ All contact records remain unchanged
✅ Contact properties preserved
✅ Contact associations intact
✅ Email addresses and billing information unchanged

Action Required: None. HubSpot contacts are not modified.

Quotes and Line Items:

✅ All quote records preserved
✅ Line items unchanged
✅ Quote amounts and status intact

Action Required: None.

CRM Cards:

❌ QuickBooks Invoices tab removed from deal records
❌ No longer visible to any users
❌ Card configuration deleted

Impact: Users will no longer see the QuickBooks Invoices tab on deals. To create invoices after uninstall, users must log into QuickBooks directly.

3. Integration Configuration (Deleted)

OAuth Tokens:

❌ Access tokens permanently deleted
❌ Refresh tokens permanently deleted
❌ Cannot be recovered or restored

Impact: The connection between HubSpot and QuickBooks is severed. The integration can no longer read from or write to QuickBooks.

Privacy Benefit: We can no longer access your QuickBooks data. Your financial information is completely private after deletion.

Client Credentials:

❌ Encrypted Client ID deleted
❌ Encrypted Client Secret deleted
❌ Cannot be recovered

Impact: You must re-enter credentials if you reinstall.

Note: Your original Client ID and Secret are still available in the Intuit Developer Portal. Deletion only affects the encrypted copies stored by our integration.

Default Settings:

❌ Default tax codes deleted
❌ Default products deleted
❌ Environment selection (Sandbox/Production) reset

Impact: If you reinstall, you must reconfigure your default settings.

Settings Page:

❌ Settings interface removed
❌ Authentication tab no longer accessible
❌ Defaults tab no longer accessible

Impact: You cannot access settings after uninstall. Reinstall required to regain access.

What Happens During Uninstall

When you click Uninstall in HubSpot’s Connected Apps:

Immediate (< 1 second):

HubSpot sends uninstall webhook to our backend
OAuth tokens located by HubSpot account ID
Access token permanently deleted from database
Refresh token permanently deleted from database
Encryption keys for your account rotated (old encrypted data becomes unreadable)

Within 5 seconds: 6. Client ID and Secret deleted from database 7. Default settings (tax codes, products) deleted 8. Environment preference reset

Within 30 seconds: 9. CRM card removed from all deal records 10. Settings page becomes inaccessible 11. App removed from your Connected Apps list

Within 1 minute: 12. Background cleanup processes complete 13. Audit logs record the uninstall event 14. No data about your account remains except uninstall timestamp

After uninstall:

All API calls to QuickBooks fail (no tokens)
No background jobs can access your data
No processes have access to your QuickBooks account
Complete data privacy restored

Data Retention Policy

What We Keep

After uninstall, we retain only:

Uninstall timestamp (for analytics)
HubSpot account ID (to prevent duplicate reinstalls during grace period)

We do NOT retain:

OAuth tokens (deleted immediately)
Client credentials (deleted immediately)
Settings or preferences (deleted immediately)
Any QuickBooks data (never stored)
Any HubSpot data (never stored)

Retention Period

OAuth tokens: 0 days (deleted immediately, no backup)
Credentials: 0 days (deleted immediately, no backup)
Settings: 0 days (deleted immediately)
Uninstall metadata: 90 days (timestamp and account ID only)

After 90 days, even the uninstall timestamp is purged.

Cannot Be Undone

Warning: Uninstalling cannot be reversed. Once you click Uninstall:

❌ You cannot “undo” the uninstall ❌ You cannot restore OAuth tokens ❌ You cannot recover settings ❌ You cannot retrieve encrypted credentials

✅ You CAN reinstall the app from HubSpot Marketplace ✅ You CAN reconnect to QuickBooks with the same credentials ✅ You CAN reconfigure settings (must start fresh)

Reinstallation

If you uninstall and later want to use the integration again:

What You’ll Need to Do

Reinstall from HubSpot Marketplace: Install the app again like a first-time install
Approve OAuth Scopes Again: Re-approve all scopes during installation
Re-enter Credentials: Enter your Client ID and Client Secret again (retrieve from Intuit Developer Portal)
Reconnect to QuickBooks: Complete the OAuth flow again
Reconfigure Settings: Set up default tax codes and products again

What Will Be the Same

✅ Your QuickBooks invoices and customers are still there
✅ Your HubSpot deals and contacts unchanged
✅ You can reconnect to the same QuickBooks company
✅ Historical data preserved

What Will Be Different

❌ Must reconfigure all settings from scratch
❌ No memory of previous configuration
❌ Starts as a fresh install

Estimated Time to Reinstall and Reconnect: 10-15 minutes

See our Reinstallation Guide for detailed steps.

Alternatives to Uninstalling

Before you uninstall, consider these alternatives:

Option 1: Disconnect QuickBooks Only

Instead of uninstalling completely:

Go to Settings → Integrations → QuickBooks Invoicing
Click Disconnect (not Uninstall)
OAuth tokens deleted, but app remains installed
CRM card stays visible (shows “Not Connected”)
Reconnect anytime by entering credentials again

Benefits:

Faster to reconnect (no reinstall)
Settings preserved (tax codes, products)
CRM card remains for future use

See Disconnect QuickBooks guide.

Option 2: Switch Environments

If you want to switch from Sandbox to Production (or vice versa):

Disconnect from current environment
Change environment selector in Settings
Enter appropriate credentials
Reconnect to QuickBooks

No uninstall needed!

See Environment Selection guide.

Option 3: Contact Support

If you’re experiencing issues:

Don’t uninstall due to temporary problems
Contact support first: support@structur.app
Many issues can be resolved without disconnecting

How to Uninstall

If you’ve read everything above and still want to uninstall:

Step 1: Backup QuickBooks Data (Optional)

If you want a record of invoices created by the integration:

Log into QuickBooks Online
Go to Sales → Invoices
Export invoices to Excel/PDF if desired
Note customer records created by the integration

Step 2: Decide on QuickBooks Cleanup

Choose whether to:

Keep invoices and customers in QuickBooks (recommended)
Make customers inactive in QuickBooks
Delete specific invoices if needed (must be done before uninstall)

Step 3: Inform Your Team

If multiple users use the integration:

Notify them that the QuickBooks Invoices card will disappear
Provide alternative invoicing methods
Update any documentation or processes

Step 4: Uninstall from HubSpot

In HubSpot, click the Settings gear icon (top right)
Navigate to Integrations → Connected Apps
Find QuickBooks Invoicing
Click Uninstall or Remove
Confirm the action when prompted

Step 5: Verify Uninstall

After uninstalling, verify:

App no longer appears in Connected Apps
QuickBooks Invoices tab removed from deal records
Settings page inaccessible
QuickBooks data still accessible in QuickBooks Online
HubSpot deals and contacts unchanged

Frequently Asked Questions

Will my invoices in QuickBooks be deleted?

No. Invoices created in QuickBooks are permanent and remain in your QuickBooks account indefinitely, even after uninstalling the integration.

Can I get my OAuth tokens back after uninstalling?

No. OAuth tokens are permanently deleted and cannot be recovered. You must complete a new OAuth flow if you reinstall.

Will uninstalling affect my HubSpot data?

No. Your HubSpot deals, contacts, quotes, and all other data remain completely unchanged. Only the CRM card is removed.

Can you still access my QuickBooks data after I uninstall?

Absolutely not. Once your OAuth tokens are deleted, we have zero access to your QuickBooks account. The tokens are the only method of accessing your data, and they are permanently deleted upon uninstall. We cannot access your financial information, invoices, or customer data after disconnection.

How do I reinstall if I change my mind?

Follow the Reinstallation Guide. You’ll need to reinstall from the HubSpot Marketplace, re-enter your credentials, and reconnect to QuickBooks.

Will my Client ID and Secret still work?

Yes. Your Intuit Developer app and credentials remain active in the Intuit Developer Portal. You can use the same credentials if you reinstall.

Do I need to delete my Intuit Developer app?

No. You can leave your Intuit Developer app active. It does no harm and you may want to use it again in the future.

What if I just want to disconnect temporarily?

Use Disconnect QuickBooks instead of uninstalling. This preserves your settings and makes reconnecting faster.

Next Steps

Based on your decision:

If You’re Uninstalling

Follow the uninstall steps above
Optionally clean up QuickBooks data manually
See Reinstallation Guide if you change your mind later

If You’re Just Disconnecting

Disconnect QuickBooks - Temporary disconnection guide

If You’re Switching Environments

Environment Selection - Switch between Sandbox and Production

If You’re Troubleshooting

Contact Support - We can help resolve issues without uninstalling