hubspot-get-associations

📁 abdullahbeam/nexus-design-abdullah 📅 Jan 19, 2026
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 details
  • hubspot-list-companies – Get company details
  • hubspot-list-deals – Get deal details