Suppress Global Unsubscribes
Skill Warning ActiveIdentify and suppress globally unsubscribed contacts to ensure legal compliance and reduce billing. Hybrid approach: API for discovery and audit, manual UI for suppression (hs_marketable_status is read-only).
To ensure legal compliance and reduce billing by identifying and suppressing contacts who have globally unsubscribed from marketing communications in HubSpot.
Features
- Identifies globally unsubscribed contacts via HubSpot API
- Audits contacts by lifecycle stage and marketing status
- Creates a dynamic HubSpot active list for suppression
- Provides Python scripts for before and after state verification
- Includes clear instructions for manual UI suppression step
Use Cases
- Reducing marketing spend by removing non-marketable contacts
- Ensuring compliance with CAN-SPAM, GDPR, and CASL regulations
- Auditing the current state of unsubscribed contacts
- Automating the identification of contacts to suppress
Non-Goals
- Re-subscribing contacts without explicit consent
- Deleting contacts from HubSpot
- Directly suppressing contacts via the API (due to HubSpot's limitations)
- Handling subscription-type-specific opt-outs
Practices
- Database hygiene
- Compliance
- Automation
Prerequisites
- A HubSpot private app access token with `crm.objects.contacts.read` and `crm.lists.read`/`crm.lists.write` scopes
- Python 3.10+ with `uv`
- A `.env` file containing `HUBSPOT_ACCESS_TOKEN`
- Super Admin or Marketing Hub Admin permissions for manual UI suppression
Maintenance
- critical:Commit recencyThe last commit was over 3 months ago (2026-03-26), indicating the skill may be unmaintained and potentially out of sync with HubSpot API changes.
- warning:Dependency ManagementDependencies are listed in script comments but not pinned via a lockfile, increasing the risk of unexpected behavior due to dependency updates.
Execution
- warning:Pinned dependenciesDependencies are listed in comments but not pinned with a lockfile, which could lead to versioning conflicts or instability.
Installation
First, add the marketplace
/plugin marketplace add TomGranot/hubspot-admin-skills/plugin install hubspot-admin-skills@hubspot-admin-skillsQuality Score
WarningTrust Signals
Similar Extensions
Lifecycle Progression Workflow
100Build workflows to automate contact progression through the sales funnel: Lead to MQL to SQL to Opportunity to Customer. Each transition is triggered by a specific event (score threshold, meeting booked, deal created, deal won).
Review Bounced Contacts
98Weekly manual review of contacts with 3+ bounce events. Decide whether to delete or attempt recovery for each flagged contact. Prevents over-suppression while removing truly bad data.
Delete No Email Contacts
98Delete contacts with no email address from a HubSpot CRM instance. These contacts cannot receive any communication and inflate billing. Fully automated via the HubSpot CRM Search and Batch Archive APIs.
Master Claude for Legal
100Master skill for legal teams using Claude. Loads the right reference for the user's question (privilege configuration, MCP hardening, verification, long documents, practice-area patterns, skill authoring) and routes to specialized starter skills (NDA triage, version diff, meeting brief, citation verification, status synthesis). Auto-invokes when the user mentions legal work, contracts, redlines, NDAs, privilege, attorney-client, court filings, depositions, regulatory compliance, or asks how to set up Claude for a law firm or in-house legal team.
Cleanup Dashboards
100Audit and consolidate HubSpot reporting dashboards. Identifies unused, duplicate, or outdated dashboards. Must be performed manually — no dashboard API is available.
Reassign Deactivated Owners
99Reassign contacts and companies from deactivated team members to active owners. Fully automated via the HubSpot Owners API and Batch Update API. Includes territory analysis for informed reassignment decisions.