Hubspot Opportunity Exclusions

Last updated: April 29, 2026

When creating exclusions based on HubSpot properties, use the property's INTERNAL NAME value rather than the LABEL value displayed in the UI. This is a critical technical detail that can cause exclusions to fail silently if configured incorrectly.

Setup Steps:

  1. In HubSpot, go to CRM → Companies → Actions → Edit properties

  2. Search for your target property (e.g., "Lifecycle Stage") and note the INTERNAL NAME value for your desired option (e.g., "Customer")

  3. In Unify's exclusion settings, use this internal name value in your filter criteria

Why this matters: Unify accesses HubSpot data at the API level, which uses internal names rather than display labels. Using the wrong value will cause the exclusion to appear configured but not actually filter contacts, leading to unexpected enrollments.

Common examples:

  • Lifecycle stages: Use internal values like "customer" instead of display labels like "Customer". Important: Multi-word lifecycle stages are stored without spaces (e.g., use "SalesQualifiedLead" for "Sales Qualified Lead", "MarketingQualifiedLead" for "Marketing Qualified Lead")

  • Deal stages: Use internal pipeline stage IDs rather than stage names

  • Custom properties: Always verify the internal name matches your exclusion criteria

Account-level exclusions and associated records:

When creating exclusions that target accounts/companies, Unify evaluates ALL records associated with that account, including subsidiaries, acquired companies, or any other linked entities. This means a parent company could be excluded if any of its associated records meet the exclusion criteria, even if the parent company itself doesn't have that status.

Contact-level vs. company-level exclusions:

Unify's native HubSpot deal/opportunity exclusions operate at the company level only. This means when you create an exclusion based on deal stage or other opportunity fields, it will exclude all contacts at that company, not just the specific contacts associated with the deal.

If you need to exclude only contacts directly associated with deals (while keeping other contacts at the same company eligible):

  1. Create a contact-level field in HubSpot (e.g., a checkbox or select property like "Has associated deal in stage X")

  2. Use a HubSpot workflow or list membership to populate that field for contacts tied to deals in your target stages

  3. Sync that field to Unify and create a people-level exclusion using it (remember to use the internal name of your custom property)

This workaround allows you to target individual contacts based on their deal associations without affecting all contacts at the company.

Domain-grouped records:

When filtering accounts/companies, Unify automatically groups all HubSpot company records that share the same domain and evaluates them together. A company appears in the audience if any of its domain‑grouped records meet the filter criteria, even if the primary record you see in HubSpot does not.

  1. Investigate linked records: open the company in Unify and check the Linked Records tab for multiple records sharing the same domain.

  2. Check field values across all records: one linked record may match your filter criteria unintentionally.

  3. Review domain variations: look for duplicate, subsidiary, or acquired company records that share the same domain but have differing property values.

  • Add an "AND" condition with Company Name Is Not [Parent Company Name] to specifically exclude the parent company from the exclusion rule

  • Review all associated records for an account if exclusions aren't working as expected

Troubleshooting tip: If contacts are still being enrolled despite having exclusions that should apply, verify you're using internal names rather than display labels in your exclusion configuration. If accounts are being unexpectedly excluded, check if any associated records (subsidiaries, acquired companies, etc.) meet the exclusion criteria.