How to reconnect a HubSpot portal
Learn when and how to reconnect your HubSpot portal in Brave Tools — permission changes, token expiry, and troubleshooting.
Why might you need to reconnect?
There are a few situations where you may need to reconnect your HubSpot portal:
- We added new features that require additional HubSpot permissions (scopes)
- Your access token expired and could not be automatically refreshed
- A HubSpot admin uninstalled or modified the Brave Tools app
- Permissions were changed in your HubSpot portal settings
How to tell if you need to reconnect
Brave Tools will show a Reconnect needed badge next to your portal in the Connections page. You may also see tools that stop working, error messages about missing permissions, or a red dot indicator on the Connections nav item.
Steps to reconnect
- Go to Connections in the sidebar
- Find the portal that needs reconnecting
- Click the Reconnect button
- Review the permissions required in the dialog
- Click Reconnect now — you will be redirected to HubSpot
- Sign in to HubSpot (if not already signed in)
- Approve the requested permissions
- You will be redirected back to Brave Tools automatically
Reconnecting does not delete data
Reconnecting only refreshes your authentication — it does not delete any campaigns, packs, or cards you have created, reset your SMS credits, or affect other connected portals.
What if reconnecting fails?
- Check that you have appropriate access in HubSpot
- Try a different browser — cookie or extension issues can block OAuth
- Make sure the Brave Tools app is not blocked in your HubSpot account
- Contact support via the help icon if problems persist