hubspot-get-associations
Get associated records in HubSpot CRM. Load when user says 'get associations', 'linked records', 'contacts on deal', 'company contacts', 'related records', 'who is on this deal'.
"Get associated records in HubSpot CRM. Load when user says 'get associations', 'linked records', 'contacts on deal', 'company contacts', 'related records', 'who is on this deal'."
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 detailshubspot-list-companies- Get company detailshubspot-list-deals- Get deal details
You Might Also Like
Related Skills
gog
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
openclaw
orpc-contract-first
Guide for implementing oRPC contract-first API patterns in Dify frontend. Triggers when creating new API contracts, adding service endpoints, integrating TanStack Query with typed contracts, or migrating legacy service calls to oRPC. Use for all API layer work in web/contract and web/service directories.
langgenius
