Suppress Global Unsubscribes

Identify 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).

81 stars 19 forksFrontend & Design Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add TomGranot/hubspot-admin-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add TomGranot/hubspot-admin-skills --skill suppress-global-unsubscribes
Manual install
git clone --depth 1 https://github.com/TomGranot/hubspot-admin-skills.git /tmp/hubspot-admin-skills
mkdir -p ~/.claude/skills
cp -r /tmp/hubspot-admin-skills/skills/suppress-global-unsubscribes ~/.claude/skills/suppress-global-unsubscribes

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Suppress Globally Unsubscribed Contacts

## Purpose

Contacts who have globally unsubscribed cannot legally be sent marketing emails under CAN-SPAM, GDPR, or CASL. Despite this, they may still be classified as "marketing contacts" in HubSpot, meaning the organization is paying for contacts it cannot and must not email. This skill identifies all globally unsubscribed contacts, analyzes their lifecycle distribution, and guides suppression.

## Prerequisites

- A HubSpot service key (`HUBSPOT_ACCESS_TOKEN` in `.env`; an existing legacy private app token also works) with `crm.objects.contacts.read` and `crm.lists.read`/`crm.lists.write` scopes
- Python 3.10+ with `uv` for package management
- A `.env` file containing `HUBSPOT_ACCESS_TOKEN`
- Super Admin or Marketing Hub Admin permissions for the manual UI suppression step

## Scripts

Script paths are relative to this skill's directory. Run them from your project directory so `.env`, `data/`, and `reports/` resolve there: prefix each path with wherever this skill is installed (`skills/suppress-global-unsubscribes/` in a clone of the repo).

| Stage | Script | Run with |
|-------|--------|----------|
| Before | [`scripts/before.py`](./scripts/before.py) | `uv run scripts/before.py` |
| After | [`scripts/after.py`](./scripts/after.py) | `uv run scripts/after.py` |

There is no execute script: the marketing-status change itself must happen via a HubSpot workflow or the UI (see Key Constraint and Stage 3).

## Key Constraint
Read the full skill on GitHub

Details

Skill name
suppress-global-unsubscribes
Path
skills/suppress-global-unsubscribes/SKILL.md
License
MIT
Repo updated
10 November 2026

FAQ

What does the Suppress Global Unsubscribes skill do?

Identify 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).

How do I install the Suppress Global Unsubscribes skill?

Claude Code plugin: /plugin marketplace add TomGranot/hubspot-admin-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Suppress Global Unsubscribes popular?

It lives in TomGranot/hubspot-admin-skills, which has 81 GitHub stars and 19 forks, and is included in 1 curated skill list.

Related skills

Assign Unowned Contacts

81

TomGranot/hubspot-admin-skills

Assign an owner to marketing contacts that have no owner. Ensures every marketable contact has accountability for follow-up, proper lead routing, and accurate owner-based reporting.

Marketing, Sales & BusinessIn 1 list19

Audit API Usage

81

TomGranot/hubspot-admin-skills

Inventory the integrations, service keys, legacy private apps, and internal tooling that call HubSpot APIs, and flag anything on legacy v1-v4 endpoints or legacy app architecture ahead of HubSpot's 2027 cutoffs. Produces a migration checklist to date-based API versions and service keys.

Software DevelopmentIn 1 list19

Backfill Geo Data

81

TomGranot/hubspot-admin-skills

Enrich missing geographic data (country, state, city) on contacts and companies using HubSpot workflows, external data providers, or IP-based geolocation.

Productivity & NotesIn 1 list19

Antigravity Codex Theme

49

nkjDSLcvanv/antigravity-codex-theme

Deploy, selectively install, diagnose, configure, or troubleshoot antigravity-codex-theme (Codex pure-white/charcoal-dark theme, Chinese UI localization, 4-state session status indicator, expandable L1/L2 usage panels, and per-turn footer stats) on macOS, Windows, and Linux.

Frontend & Design

Suppress Ghost Contacts

81

TomGranot/hubspot-admin-skills

Identify and suppress ghost contacts who received marketing emails but never opened any. These contacts destroy sender reputation and deliverability. Hybrid approach: API for discovery, manual UI for suppression.

Frontend & DesignIn 1 list19

Transitions Dev

48

Jakubantalik/transitions-dev

Production-ready CSS transitions for web apps. Use when implementing notification badges, dropdowns, modals, panel reveals, page transitions, card resizes, number pop-ins, text swaps, icon swaps, success checks, avatar group hovers, or error state shakes. Triggers on "add a transition", "animate the dropdown", "make the modal open smoothly", "swap icon", "page slide", "stagger animation", "open / close transition", "make it animate", "tween the size", "fade between", "smooth open", "smooth close", "success animation", "checkmark animation", "confirmation animation", "form error", "shake on inv

Frontend & Design

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.