Hard-bounced contacts are wrecking our email deliverability
Every send to a hard-bounced address tells inbox providers you do not clean your list. Left alone, this drags down deliverability for the contacts who do want your email. The fix: find every hard bounce, suppress them from marketing sends, and automate the suppression going forward.
Fix it with one command
The suppress-hard-bounced skill walks Claude Code through the entire fix — audit, CSV baseline, execution, and verification. Ready-to-run Python scripts included.
/plugin marketplace add tomgranot/hubspot-admin-skills
/plugin install hubspot-admin@hubspot-admin-skills
/suppress-hard-bouncedFrequently asked questions
How do I find all hard-bounced contacts in HubSpot?
Search on the hs_email_hard_bounce_reason_enum property — any contact where it is set has hard-bounced at least once. The skill runs this search via the API and exports the full list to CSV.
Can I set contacts as non-marketing via the HubSpot API?
No — hs_marketable_status is read-only via the API. The supported route is a workflow that sets marketing status, which the skill builds for you (created disabled, for review).
Should I delete hard-bounced contacts or just suppress them?
Suppress first: the record keeps its history and stays available for sales. Delete only if the record has no other value — deletion is covered by a separate skill with its own audit trail.
More database hygiene skills
/delete-no-email-contactsDelete 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.
/merge-duplicate-companiesIdentify duplicate company records by domain and name, export audit CSVs for review, and guide merging. API for discovery, third-party tools or manual UI for merging (HubSpot has no bulk merge API).
/reassign-deactivated-ownersReassign 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.