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