Create Segment Lists
Skill ActiveCreate business segment lists in HubSpot for customers, partners, competitors, employees, ICP tiers, and industries. Enables segment-based targeting, suppression, and analytics.
Automate the creation of essential business segment lists in HubSpot to enable targeted marketing, sophisticated analytics, and effective suppression strategies.
Features
- Create core business segments (Customers, Partners, Competitors, Internal)
- Generate ICP tier-based segments
- Build industry-specific segment lists
- Define engagement-based segments
- Enables segment-based targeting and suppression
Use Cases
- Use when setting up a new HubSpot portal and needing foundational segment lists.
- Use when defining target audiences for marketing campaigns.
- Use when cleaning up or standardizing HubSpot contact data for better segmentation.
Non-Goals
- Creating or managing HubSpot workflows.
- Performing data enrichment beyond what's needed for segment criteria.
- Directly importing or exporting contact data (though lists can be used for this).
Documentation
- warning:Configuration & parameter referenceThe SKILL.md mentions a HubSpot API token in `.env` but does not explicitly document its required scopes or precedence order for configuration.
Security
- warning:Secret ManagementThe SKILL.md states the HubSpot API token should be in `.env`, but it does not explicitly state that this token should not be echoed into stdout/stderr or debug logs.
Trust
- info:Issues AttentionIn the last 90 days, 0 issues were opened and 1 was closed, indicating low issue activity but some maintainer response.
Code Execution
- info:ValidationThe Python script uses the HubSpot API client, which likely has internal validation, but explicit schema-based validation for inputs and outputs is not detailed in the SKILL.md.
- info:Error HandlingThe SKILL.md provides Python code, which implies standard Python error handling, but does not detail specific error categorization, retry logic, or structured error reporting for the agent.
Compliance
- info:GDPRThe skill operates on HubSpot CRM data. While it doesn't explicitly target personal data, it could process it, and there's no specific mention of sanitization before submission to the LLM.
Errors
- info:Actionable error messagesWhile the Python script implies error handling, the SKILL.md does not explicitly detail error messages, root causes, or specific remediation steps for user-facing errors.
Execution
- info:Pinned dependenciesThe SKILL.md specifies Python 3.10+ and `hubspot-api-client`, but a lockfile is not explicitly provided, and interpreter pinning via shebang is not detailed for the Python script.
Protocol
- info:Idempotent retry & timeoutsThe provided Python code does not explicitly detail idempotency for list creation or enforce hard per-call timeouts with structured retryable errors.
Practical Utility
- info:Edge casesThe SKILL.md mentions reviewing existing lists and verifying member counts, but does not explicitly list failure modes (e.g., API errors, rate limits, invalid property values) with symptoms and recovery steps.
Safety
- info:Halt on unexpected stateThe SKILL.md mentions checking for existing lists and verifying member counts, but does not explicitly list preconditions or instruct to abort on unexpected pre-state, such as missing properties or API token issues.
Installation
First, add the marketplace
/plugin marketplace add TomGranot/hubspot-admin-skills/plugin install hubspot-admin-skills@hubspot-admin-skillsQuality Score
Trust Signals
Similar Extensions
Lifecycle Progression Workflow
100Build workflows to automate contact progression through the sales funnel: Lead to MQL to SQL to Opportunity to Customer. Each transition is triggered by a specific event (score threshold, meeting booked, deal created, deal won).
Enrich Contact Industry
99Backfill contact-level industry from associated company records using a HubSpot workflow. Enables industry-based segmentation for targeted campaigns aligned with ICP verticals.
Cleanup Dashboards
100Audit and consolidate HubSpot reporting dashboards. Identifies unused, duplicate, or outdated dashboards. Must be performed manually — no dashboard API is available.
Reassign Deactivated Owners
99Reassign 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.
Weekly Cleanup Routine
98A lightweight 5-minute weekly health check covering bounce monitoring, new contact quality, workflow health, list growth trends, and data quality sampling. Quick early warning system, not a comprehensive audit.
Review Bounced Contacts
98Weekly manual review of contacts with 3+ bounce events. Decide whether to delete or attempt recovery for each flagged contact. Prevents over-suppression while removing truly bad data.