View as Markdown
HubSpot icon

HubSpot ACTION

List Associated Engagements

List engagements (notes, tasks, calls, meetings, emails, etc.) associated with a CRM record using HubSpot's legacy Engagements v1 paged API. This endpoint is documented for company, deal, and quote; other object types may return errors. Use Offset for pagination when hasMore is true. For newer CRM v3 engagement objects, prefer v4 List CRM Associations from the record to notes, tasks, calls, etc. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's HubSpot account once, then configure and run List Associated Engagements from your backend or agent.

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-associated-engagements",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hubspot: { authProvisionId: "apn_xxxxxxx" },
    objectType: "CRM Object Type",
    objectId: "Object ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Associated Engagements inputs
Property Type Description
objectType CRM Object Type string
Type of CRM record to load engagements for. Legacy API: typically company, deal, or quote.
Required Dynamic
objectId Object ID string
HubSpot ID of the record. After choosing CRM Object Type, pick from the list or enter an ID (for contacts you can search by email).
Required Dynamic
offset Offset integer
Pagination offset from the legacy API (default 0).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
hubspot-list-associated-engagements
Version
0.0.7
App
HubSpot
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes