hubspot-get-associations
10
总安装量
8
周安装量
#30223
全站排名
安装命令
npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill hubspot-get-associations
Agent 安装分布
claude-code
7
antigravity
6
windsurf
6
opencode
6
gemini-cli
6
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 detailshubspot-list-companies– Get company detailshubspot-list-deals– Get deal details