Requisiti: un account HubSpot con permessi per creare app private (paragrafo 2).
- Accedi al tuo account HubSpot e vai su Impostazioni → Integrazioni → App private.
- Premi Crea un’app privata. Dalle un nome riconoscibile — per esempio quello della tua attività, mai uno generico come «prova».
- Vai alla scheda Scopes («Ambiti») e seleziona questi cinque permessi — sono i minimi di cui il connettore ha bisogno, non uno di più:
| Scope | A cosa serve al connettore |
|---|---|
crm.objects.contacts.read | Cercare e leggere contatti esistenti. |
crm.objects.contacts.write | Creare o aggiornare un contatto (azione «lead → contatto», paragrafo 5). |
crm.objects.deals.read | Cercare trattative (deal) esistenti. |
crm.objects.deals.write | Creare una trattativa o cambiarne la fase (azione «fase → trattativa», paragrafo 5). |
crm.objects.owners.read | Leggere i proprietari (utenti di HubSpot) di un contatto o di una trattativa. |
- Salva l’app. HubSpot mostra il token di accesso, nel formato
pat-eu1-…— copialo prima di chiudere la finestra: per sicurezza, HubSpot lo mostra per intero solo questa prima volta (dopo puoi rivelarlo di nuovo dalla scheda Auth della stessa app se ti serve ancora).
Avviso — Verificato con la documentazione ufficiale — un nome che può variare
Il percorso Impostazioni → Integrazioni → App private sopra è quello usato da questa guida perché è quello che descrive il modulo di connessione della Platform. Consultando la documentazione ufficiale di HubSpot per questo manuale (
developers.hubspot.com/docs/api/private-appsedevelopers.hubspot.com/docs/guides/apps/private-apps/overview, consultate il 5 settembre 2026), HubSpot oggi chiama questo stesso meccanismo «Legacy private apps» («app private legacy») e lo colloca nel menu Development → Legacy apps → Create legacy app → Private del suo portale sviluppatori. HubSpot mantiene il meccanismo — un token di app privata continua a funzionare allo stesso modo — ma potrebbe aver rinominato o spostato il menu nel tuo account a seconda di quando è stato creato. Se non trovi «App private» dove indica il passo 1, cerca «Legacy apps» («app legacy»); questo avviso verrà rimosso non appena la sessione di acquisizione confermi il percorso esatto che vede oggi un amministratore nuovo.