hubspot-get-associations

Retrieve associated records between HubSpot CRM contacts, companies, and deals.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-get-associations-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-get-associations
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-get-associations
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-get-associations-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding which records are linked together in HubSpot CRM—such as which contacts belong to a deal or which company a contact works at—normally requires manual navigation through the CRM interface. This Skill retrieves those associations directly via the HubSpot API. ## Core Features & Use Cases - Association Retrieval: Query linked records between contacts, companies, and deals using object type and ID parameters. - Structured JSON Output: Returns association results with object IDs and association type labels for downstream processing. - Use Case: A sales rep asks "who is on this deal?" and instantly gets the list of contact IDs associated with deal 5840795376, ready for follow-up lookups. ## Quick Start Ask the AI to show all contacts associated with a specific HubSpot deal by providing the deal ID.

Frequently Asked Questions about hubspot-get-associations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get contacts associated with a HubSpot deal?

Run the get_associations.py script with --object-type deals, the deal ID, and --to-type contacts. It returns a JSON list of associated contact IDs with their association type labels.

How to find which company a HubSpot contact belongs to?

Query associations with --object-type contacts, the contact ID, and --to-type companies. The output lists the linked company IDs, which you can look up with the company listing skill for full details.

What HubSpot object types support association lookups?

This skill supports contacts, companies, and deals as both source and target object types. Other HubSpot objects like tickets or custom objects are not covered by the documented commands.

Why does the HubSpot associations query return a 403 error?

A 403 error means the API token lacks the read scope for the requested object type. Re-run the HubSpot setup to grant the required scopes, then retry the association query.

Does the HubSpot associations script require authentication setup first?

Yes, a pre-flight check runs check_hubspot_config.py before any query. If the config check does not return proceed_with_operation, you must complete the hubspot-connect setup guide first.