Agent skill
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'.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/devops/hubspot-get-associations
SKILL.md
Get HubSpot Associations
Specialized skill for retrieving associated records between HubSpot CRM objects.
Pre-Flight Check
Before running, execute config check:
bash
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:
bash
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:
bash
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:
bash
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:
bash
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
json
{
"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
Didn't find tool you were looking for?