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 --jsonIf 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 \
--jsonGet contacts at a company:
python 00-system/skills/hubspot/hubspot-master/scripts/get_associations.py \
--object-type companies \
--object-id 6493611979 \
--to-type contacts \
--jsonGet deals for a contact:
python 00-system/skills/hubspot/hubspot-master/scripts/get_associations.py \
--object-type contacts \
--object-id 12345 \
--to-type deals \
--jsonGet company for a contact:
python 00-system/skills/hubspot/hubspot-master/scripts/get_associations.py \
--object-type contacts \
--object-id 12345 \
--to-type companies \
--jsonValid 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 detailshubspot-list-companies- Get company detailshubspot-list-deals- Get deal details