Why am I seeing "missing permissions" errors?

What causes this error?

Missing permissions errors happen when:

• Brave Tools added a new feature that requires additional HubSpot access
• Your HubSpot admin removed or restricted the Brave Tools app
• You connected a portal before we added a specific scope we now need

What are scopes?

Scopes are HubSpot permissions. When you connect a portal, you authorize Brave Tools to access specific parts of your HubSpot data. For example:

• hubdb: read and write HubDB tables
• files: manage files in File Manager
• crm.lists: read and use HubSpot lists (needed for SMS Campaigns)
• crm.schemas.contacts: read contact properties (needed for Property Pack Builder)

Different tools need different scopes. When we add a new feature, it may need a new scope.

How to fix it

1. Go to Connections in the sidebar
2. Find the portal with the missing permissions badge
3. Click Reconnect
4. Review the updated list of scopes
5. Click Reconnect now
6. Sign in to HubSpot if needed
7. Approve the new scopes

After reconnecting, the error should be resolved.

Which scopes are needed?

We request different scopes depending on which tools you use:

• HubDB Editor: hubdb
• Files: files
• Property Pack Builder: crm.schemas.contacts, crm.schemas.companies, crm.schemas.deals
• SMS Campaigns: crm.lists.read, crm.objects.contacts.read
• Annual Planner (HubSpot sync): marketing.campaigns.read

See our HubSpot scopes and what they do article for the full list.

HubSpot admin restrictions

If your HubSpot admin restricts which apps can access the portal, they may need to whitelist Brave Tools. Ask them to check under Settings > Integrations > Connected Apps in HubSpot.

Still seeing the error after reconnecting?

1. Try a different browser (cookie or extension issues can block OAuth)
2. Check that you are signed in to the correct HubSpot account
3. Verify your HubSpot user has appropriate access to the relevant features
4. Contact support via the help icon