Get HubSpot Associations

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

---

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

---

Error Handling

---

Related Skills

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