What happens if my HubSpot access token expires?

The skill identifies 401 Unauthorized responses, attempts an automatic refresh if a refresh token is available, or pauses the workflow for a re-authentication prompt.

Does it support HubSpot sandbox environments?

Yes, it specifically detects and flags 'postauth quirks' where sandbox portals might incorrectly return production portal IDs during authentication.

Can this skill prevent accidental writes to the wrong HubSpot environment?

Yes, it enforces lifecycle guardrails that block write operations if the runtime portal ID from the API header does not match the session's configured portal ID.

How does this skill handle HubSpot portal switches?

It detects mid-session portal ID changes, invalidates all cached metadata and property lists, and forces a live-first refresh to ensure data consistency.

HubSpot Portal Lifecycle Manager

Name: HubSpot Portal Lifecycle Manager
Author: RevPalSFDC

byRevPalSFDC

•

营销自动化

Manages HubSpot authentication context, portal switches, and stale credential recovery for consistent API session stability.

The hubspot-portal-runtime-lifecycle skill provides a robust framework for managing the complete lifecycle of HubSpot portal authentication within Claude Code. It ensures session stability by handling complex scenarios such as stale credential recovery, automatic token refreshes, and secure portal switching. By implementing strict lifecycle guardrails, it prevents common errors like writing data to the wrong portal ID and detects 'postauth' quirks common in sandbox environments. This skill is essential for developers and RevOps teams who need reliable, multi-portal HubSpot interactions without manual session management overhead.

主要功能

011 GitHub stars

02Write-operation guardrails based on runtime portal ID matching

03Stale credential detection and automatic 401/403 recovery

04Post-authentication validation for sandbox and production safety

05Structured audit logging for all portal lifecycle transitions

06Secure portal-switching with automatic cache invalidation

使用场景

01Safely switching between HubSpot sandbox and production environments

02Preventing accidental data writes to mismatched HubSpot portals

03Automating session recovery after credential expiration during long-running tasks

主要功能

011 GitHub stars

02Write-operation guardrails based on runtime portal ID matching

03Stale credential detection and automatic 401/403 recovery

04Post-authentication validation for sandbox and production safety

05Structured audit logging for all portal lifecycle transitions

06Secure portal-switching with automatic cache invalidation

使用场景

01Safely switching between HubSpot sandbox and production environments

02Preventing accidental data writes to mismatched HubSpot portals

03Automating session recovery after credential expiration during long-running tasks