suppress-global-unsubscribes

To suppress globally unsubscribed contacts in HubSpot, this skill uses API-based discovery to audit your contacts and guides you through manual UI suppression steps, ensuring GDPR and CAN-SPAM compliance while reducing unnecessary marketing contact billing.

Globally unsubscribed contacts can still be marketed to and billed in HubSpot if their marketing status is not properly suppressed. This skill identifies those contacts via API and guides suppression through a dynamic list to eliminate unnecessary billing.

You need a HubSpot access token with proper API scopes, along with the requests and python-dotenv libraries. The skill performs discovery and lifecycle distribution analysis to surface edge cases before suppression.

No, suppression follows a hybrid workflow. The API handles discovery and audit of globally unsubscribed contacts, but final non-marketing status suppression requires manual UI actions in HubSpot for large lists.

The best way to audit lifecycle distribution is running the before.py script, which generates an audit and dynamic suppression list by analyzing lifecycle stages to surface edge cases and inform your suppression strategy.

To verify suppression results, run the after.py script after completing the manual UI suppression steps. This checks that globally unsubscribed contacts have been properly marked as non-marketing to ensure compliance.