suppress-ghost-contacts
CommunitySuppress ghost contacts to protect deliverability.
Data & Analytics#hubspot#deliverability#data-cleanup#suppression#marketing-status#ghost-contacts#not_has_property
AuthorTomGranot
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Ghost contacts who have received marketing emails but never opened any threaten sender reputation and email deliverability. This Skill helps identify and suppress those unengaged contacts in a controlled, auditable way.
Core Features & Use Cases
- API-driven discovery of ghost contacts (delivered > 0, opened = null, bounced = null) and before/after state verification.
- CSV export for audit trails and segmentation, plus dynamic HubSpot lists to drive suppression workflows.
- Hybrid suppression workflow: leverage API-based discovery and a manual HubSpot UI action to set marketing contact status without deleting CRM data.
Quick Start
Run the before.py script to audit ghost contacts, then run the after.py script to verify suppression, and finally use HubSpot UI to set contacts in the CLEANUP: Ghost Contacts list to non-marketing.
Dependency Matrix
Required Modules
requests>=2.31python-dotenv>=1.0
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: suppress-ghost-contacts Download link: https://github.com/TomGranot/hubspot-admin-skills/archive/main.zip#suppress-ghost-contacts Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.