(Documentation) Update required scopes for HubSpot Trigger node

[sias-agenbag]

I believe the list of scopes in the documentation was outdated - I had to add the following to the list to allow me to connect n8n to my HubSpot instance

Added new required scopes for HubSpot Trigger node, including permissions for Conversations, Companies, Contacts, Deals, Lists, Owners, Forms, and Tickets.

---

Summary by cubic

Updated the HubSpot Trigger credential docs to list the full required OAuth scopes. Adds Conversations, Lists, Owners, Forms, Tickets, and write access for Companies, Contacts, and Deals to prevent connection issues.

^{Written for commit 0e4aead. Summary will update on new commits.}

[netlify]

✅ Deploy Preview for n8n-docs ready!

Name	Link
🔨 Latest commit	0e4aead
🔍 Latest deploy log	https://app.netlify.com/projects/n8n-docs/deploys/6a030499bae31b0007f23877
😎 Deploy Preview	https://deploy-preview-4619--n8n-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[cubic-dev-ai]

No issues found across 1 file

Architecture diagram

sequenceDiagram
    participant User as n8n User
    participant n8n as n8n Workflow
    participant Cred as HubSpot Credential
    participant OAuth as HubSpot OAuth Server
    participant API as HubSpot API

    User->>n8n: Configure HubSpot Trigger node
    n8n->>Cred: Request OAuth authorization
    Cred->>OAuth: Request authorization with scope list
    
    Note over Cred,OAuth: Scope list includes Conversations, CRM objects (read+write), Lists, Owners, Forms, Tickets

    alt Missing required scopes
        OAuth-->>Cred: Authorization failed
        Cred-->>n8n: Error: insufficient scopes
        n8n-->>User: Connection error
    else All required scopes granted
        OAuth-->>Cred: Authorization code
        Cred->>OAuth: Exchange for access token
        OAuth-->>Cred: Access token with scopes
        
        loop Polling or Webhook Events
            n8n->>API: Fetch subscribed events 
            alt Conversations events
                API-->>n8n: Conversation data
            else CRM events (Companies, Contacts, Deals)
                API-->>n8n: CRM object data (read+write)
            else Lists events
                API-->>n8n: List data
            else Owners events
                API-->>n8n: Owner data
            else Forms events
                API-->>n8n: Form submission data
            else Tickets events
                API-->>n8n: Ticket data
            end
            
            n8n->>n8n: Process event and trigger workflow
            n8n-->>User: Workflow executed with event data
        end
    end

Loading

[CLAassistant]

All committers have signed the CLA.

[RoRoJ]

Hi @sias-agenbag

Thanks for updating this doc! These two additions seem to align with the codebase:

• conversations.read
• tickets

Both of these are defined in the HubspotDeveloperApi credential (the one the Trigger node uses) but were missing from the doc.

However, you also suggested adding the following scopes:

• crm.objects.companies.write
• crm.objects.contacts.write
• crm.objects.deals.write
• crm.lists.write
• crm.objects.owners.read
• forms

These scopes belong to the HubspotOAuth2Api credential, which is used by the regular HubSpot node, not the Trigger node, which is the part of the doc you are modifying. The Trigger node only ever uses the HubspotDeveloperApi credential (it's hardcoded in the node source). Those scopes are already documented in the Required scopes for HubSpot node section below.

Do you agree with this, and if so could you modify your PR accordingly?

Thanks again