hubspot.

hubspot s'authentifie via un token de private app. dans les réglages de ton compte hubspot, va dans integrations → private apps, crée une private app et coche les scopes :

⚠️ si ta private app date d'avant, elle n'a que les scopes crm.objects.* et hubspot_list répondra 403. ça ne veut pas dire que ta clé est mauvaise : rouvre la private app et ajoute le scope, le token ne change pas.

⚠️ le token attendu est l'access token de la private app (forme pat-<région>-…). si tu colles autre chose — typiquement un *refresh token* oauth, un long blob base64 qui commence par Ci… — hubspot répond 401 `EXPIRED_AUTHENTICATION` avec un message trompeur du genre « expired 20697 day(s) ago » et une date d'expiration au 1er janvier 1970. rien n'a expiré : un refresh token n'a pas de champ d'expiration, donc envoyé en bearer il est lu comme expiré depuis l'epoch. ce message-là veut dire « ce n'est pas un access token », pas « ton token a vieilli ».

interroge et édite ton crm hubspot (contacts, companies, deals, tickets) depuis claude.

### segments = listes

dans hubspot, un « segment » est une liste : il n'y a pas d'api segments séparée. hubspot_list les couvre.

trois types de listes, choisis à la création et non modifiables ensuite :

vider une liste (clear_members) et la supprimer (delete) acceptent dry_run=true : ça dit ce qui partirait sans rien toucher. une liste supprimée reste restaurable 90 jours (op restore).

### propriétés — à lire avant d'écrire

les noms internes hubspot ne sont pas les libellés de l'interface (dealstage, pas « Deal Stage »), et une liste déroulante n'accepte que ses valeurs déclarées. hubspot_property (op list) donne le schéma réel d'un type d'objet — sur un portail neuf, ça fait déjà 404 propriétés sur les contacts dont 45 énumérations. c'est ce qui rend fiables les create/update de hubspot_object et les critères filter_branch d'une liste dynamique, qui référencent les propriétés par nom interne.

⚠️ une exception, vérifiée en live : dealstage revient avec une liste d'options vide. les étapes d'un deal appartiennent à un *pipeline*, pas à la propriété — les lire demande l'api pipelines, que le connecteur ne monte pas encore.