HubSpot

HubSpot integratie configureren

Tidal Control's HubSpot integratie monitort het gebruikersbeheer, beveiligingsinstellingen en dataconfiguratie van je CRM voor compliance doeleinden.

Wat deze integratie monitort:

• Users: Inactieve accounts en aantal super admins
• Owners: Koppeling met portal users
• Account: Locatie van dataopslag
• Subscriptions: Standaard opt-in instellingen op communicatietypen

Vereisten:

• Super User rol in Tidal Control
• HubSpot account met rechten om Private Apps aan te maken

Configuratie stappenplan

Wat gaan we doen: We maken een HubSpot Private App aan en kopiëren het access token, en voegen daarna de verbinding toe in Tidal Control.

Configuratie stappen:

1. Private App aanmaken in HubSpot
2. Integratie configureren in Tidal Control

Stap 1: Private App aanmaken in HubSpot

• Log in op je HubSpot account
• Klik op het instellingen-icoon (tandwiel) in de bovenste navigatiebalk
• Navigeer naar Integrations → Private Apps in de linker zijbalk
• Klik op Create a private app
• Voer op het tabblad Basic info een naam in (bijv. Tidal Control) en optioneel een beschrijving
• Ga naar het tabblad Scopes en voeg de volgende scopes toe:

Scope	Doel
crm.objects.owners.read	Owner-records lezen
settings.users.read	Users en rollen lezen
settings.users.teams.read	Teamconfiguratie lezen
audit-logs.read	Auditlog en inlogactiviteit lezen
communication-preferences.read	Subscriptietypen lezen

• Klik op Create app
• Klik in het bevestigingsvenster op Continue creating
• Kopieer het access token dat wordt getoond op de app-detailpagina

Stap 2: Integratie configureren in Tidal Control

• Ga naar Settings → Integrations in Tidal Control
• Klik op het plus-icoon naast HubSpot
• Vul de configuratie in:
  • Name: Een beschrijvende naam, bijv. HubSpot
  • Access Token: Het access token uit stap 1
• Klik op "Create" om de integratie op te slaan

Configuratie velden uitgelegd

Name:

• Een beschrijvende naam voor deze verbinding
• Bijvoorbeeld: HubSpot, HubSpot Productie

Access Token:

• Het Private App access token van HubSpot
• Aangemaakt in stap 1
• Houd deze waarde veilig

Verificatie

Controleer integratie status:

• Settings → Integrations toont "Connected" status voor HubSpot
• HubSpot tests zijn beschikbaar in de Tests sectie
• Test refresh levert resultaten zonder authenticatiefouten

Veelgestelde vragen

Kan ik hetzelfde Private App token gebruiken voor meerdere Tidal Control omgevingen? Ja, hetzelfde access token kan worden gebruikt voor verschillende Tidal Control instanties.

Wat gebeurt er als ik meer scopes toevoeg dan vermeld? Extra scopes hebben geen invloed op de integratie. Tidal Control gebruikt alleen de data die nodig is voor de geconfigureerde tests.

Moet ik HubSpot super admin zijn om een Private App aan te maken? Je hebt voldoende rechten nodig in HubSpot om integraties te beheren. Dit vereist doorgaans een super admin-rol of een account met de machtiging "App Marketplace Access".

Veelvoorkomende problemen

"Access Token is required"

• Zorg dat je de tokenwaarde hebt ingevoerd, niet de app-naam of het ID
• HubSpot Private App tokens beginnen met pat-

Tests tonen authenticatiefouten na verbinding

• Controleer of het access token nog geldig is — tokens kunnen worden geroteerd in de HubSpot Private App-instellingen
• Controleer of alle vereiste scopes zijn toegevoegd bij het aanmaken van de Private App

Test "HUBSPOT_DATA_HOSTED_IN_EU" mislukt

• Deze test controleert of je HubSpot account wordt gehost in het EU-datacentrum
• Dit is een instelling van je HubSpot account, niet van de integratie — neem contact op met HubSpot-support om de dataopslaglocatie te wijzigen

Kom je er nog niet uit?

Stuur een e-mail naar support@tidalcontrol.com, en wij nemen zo snel mogelijk contact op.