# List CRM Associations — HubSpot

> List CRM v4 associations from a source record to a target object type. Returns associated record IDs and association types for each link. Direction matters: from is the record you are querying from; swap from/to to traverse the…

- Key: `hubspot-list-crm-associations`
- Type: Action (Read-only)
- Version: 0.0.7
- App: HubSpot (`hubspot`) — https://pipedream.com/apps/hubspot.md
- This page (HTML): https://pipedream.com/apps/hubspot/actions/list-crm-associations
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/hubspot/actions/list-crm-associations/list-crm-associations.mjs

## Description

List CRM v4 associations from a source record to a target object type. Returns associated record IDs and association types for each link. Direction matters: `from` is the record you are querying from; swap from/to to traverse the relationship the other way. [See the documentation](https://developers.hubspot.com/docs/api-reference/crm/associations-v4/basic/get-crm-v4-objects-objectType-objectId-associations-toObjectType)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `fromObjectType` | `string` | Yes | Object type of the record you are listing associations from. Options are loaded from the connected account. |
| `fromObjectId` | `string` | Yes | The source record’s HubSpot ID. After choosing From Object Type, pick from the list or enter an ID (for contacts you can search by email). Options are loaded from the connected account. |
| `toObjectType` | `string` | Yes | Object type of associated records to return (e.g. contacts linked to this company). Options are loaded from the connected account. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "hubspot",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "hubspot-list-crm-associations",
  arguments: {
    fromObjectType: "From Object Type",
    fromObjectId: "From Object ID",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "hubspot-list-crm-associations",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hubspot: { authProvisionId: "apn_xxxxxxx" },
    fromObjectType: "From Object Type",
    fromObjectId: "From Object ID",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "hubspot-list-crm-associations",
    "configured_props": {
      "hubspot": { "authProvisionId": "apn_xxxxxxx" },
      "fromObjectType": "From Object Type",
      "fromObjectId": "From Object ID"
    }
  }'
```

---

- App: https://pipedream.com/apps/hubspot.md · All apps: https://pipedream.com/apps