View as Markdown
HubSpot icon

HubSpot ACTION

Get Thread

Retrieves a single thread's metadata, including status, assignee, associations, and latest-message info. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's HubSpot account once, then configure and run Get Thread 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-get-thread",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hubspot: { authProvisionId: "apn_xxxxxxx" },
    inboxId: "Inbox ID",
    channelId: "Channel 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.

Get Thread inputs
Property Type Description
inboxId Inbox ID string
The ID of an inbox
Optional Dynamic
channelId Channel ID string
The ID of a channel
Optional Dynamic
archived Archived boolean
Set to true to look up the thread in the archived collection. Defaults to false (active threads only).
Optional
threadId Thread ID string
The ID of a thread
Required Dynamic
association Association string
Association type to include in the response. Set to TICKET to include the thread's associations object and associated ticket ID, if present.
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-get-thread
Version
0.0.5
App
HubSpot
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes