Get HubSpot Associations Skill

Get HubSpot Associations

Specialized skill for retrieving associated records between HubSpot CRM objects.

Pre-Flight Check

Before running, execute config check:

python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json

If ai_action is not proceed_with_operation, follow hubspot-connect setup guide.

Usage

Required Parameters

--object-type - Source object type (contacts, companies, deals)
--object-id - Source object ID
--to-type - Target object type to find associations

Examples

Get contacts on a deal:

python 00-system/skills/hubspot/hubspot-master/scripts/get_associations.py \
  --object-type deals \
  --object-id 5840795376 \
  --to-type contacts \
  --json

Get contacts at a company:

python 00-system/skills/hubspot/hubspot-master/scripts/get_associations.py \
  --object-type companies \
  --object-id 6493611979 \
  --to-type contacts \
  --json

Get deals for a contact:

python 00-system/skills/hubspot/hubspot-master/scripts/get_associations.py \
  --object-type contacts \
  --object-id 12345 \
  --to-type deals \
  --json

Get company for a contact:

python 00-system/skills/hubspot/hubspot-master/scripts/get_associations.py \
  --object-type contacts \
  --object-id 12345 \
  --to-type companies \
  --json

Valid Object Types

| Type | Description | |------|-------------| | contacts | Contact records | | companies | Company records | | deals | Deal/opportunity records |

Output Format

{
  "results": [
    {
      "toObjectId": 12345,
      "associationTypes": [
        {
          "category": "HUBSPOT_DEFINED",
          "typeId": 3,
          "label": "Deal to Contact"
        }
      ]
    }
  ]
}

Display Format

Found 3 contacts associated with deal 5840795376:

1. Contact ID: 12345 (Deal to Contact)
2. Contact ID: 12346 (Deal to Contact)
3. Contact ID: 12347 (Deal to Contact)

Use 'search contacts --id 12345' for full details.

Common Use Cases

| User Says | Command | |-----------|---------| | "Who is on this deal?" | deals → contacts | | "What company is John at?" | contacts → companies | | "Show contacts at Acme" | companies → contacts | | "What deals does John have?" | contacts → deals |

Error Handling

| Error | Solution | |-------|----------| | 401 | Invalid token - re-run setup | | 403 | Missing read scope for object type | | 404 | Object not found - check ID | | 429 | Rate limited - wait and retry |

Related Skills

hubspot-list-contacts - Get contact details
hubspot-list-companies - Get company details
hubspot-list-deals - Get deal details

Agent Skills: Get HubSpot Associations

Install this agent skill to your local

Skill Files