suppress-hard-bounced

Identify hard-bounced HubSpot contacts, export a CSV audit log, and create a dynamic list.

58|16|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill suppress-hard-bounced
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: suppress-hard-bounced
Source: https://github.com/TomGranot/hubspot-admin-skills/tree/main/skills/suppress-hard-bounced
Command: npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill suppress-hard-bounced

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests>=2.31, python-dotenv>=1.0, and includes scripts (resource) components.

What problem does it solve?

Hard-bounced contacts waste sending capacity and damage sender reputation. This skill identifies hard-bounced contacts via API, exports an audit trail, creates a dynamic HubSpot list for ongoing monitoring, and guides the user to suppress in the UI since hs_marketable_status cannot be set via API.

Core Features & Use Cases

  • Identify and audit hard-bounced contacts across the portal and export a CSV audit log.
  • Create a dynamic HubSpot active list to monitor hard-bounce contacts over time.
  • Provide step-by-step UI suppression guidance to move contacts to non-marketing status (read-only via API) and support optional review lists for high-bounce cases.

Quick Start

Run the before-state to audit hard-bounced contacts, export an audit CSV, and create a dynamic list for suppression guidance in the UI.

Frequently Asked Questions about suppress-hard-bounced

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I suppress hard-bounced contacts in HubSpot to protect sender reputation?

To suppress hard-bounced contacts in HubSpot, this skill identifies them via API, exports a CSV audit trail, creates a dynamic active list for monitoring, and provides step-by-step UI guidance for manual suppression since the marketing flag is API read-only.

Can I change the hs_marketable_status for hard-bounced contacts using the HubSpot API?

No, the hs_marketable_status cannot be set via API. This skill reads hard bounce reasons through the API and generates step-by-step UI instructions to manually suppress those contacts to non-marketing status.

How do I audit and export hard-bounced contacts from HubSpot for a data audit?

You can audit hard-bounced contacts by running the skill's before-state script, which queries the HubSpot API for bounce reasons and exports a CSV audit log containing all identified hard-bounced contacts across the portal.

Does this skill require any specific HubSpot API permissions to identify hard-bounced contacts?

Yes, the skill requires HubSpot API access to read specific contact properties including hs_email_hard_bounce_reason_enum and hs_marketable_status, as well as the ability to create dynamic active lists for ongoing monitoring.

Why does this skill create a dynamic HubSpot list for hard-bounced contacts?

The skill creates a dynamic HubSpot active list to automatically monitor hard-bounce contacts over time, ensuring ongoing sender reputation protection by continuously tracking new bounces as they occur in the portal.

What's the best way to handle high-bounce cases when suppressing hard-bounced contacts?

For high-bounce cases, the skill supports optional review lists alongside the dynamic monitoring list and UI suppression guidance, allowing you to carefully review and manage contacts with severe bounce issues before final removal.