View as Markdown
HubSpot icon

HubSpot ACTION

List Threads

Retrieves a list of threads. 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 Threads 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-threads",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hubspot: { authProvisionId: "apn_xxxxxxx" },
    associatedContactId: "Associated Contact ID",
    association: "Association",
  },
})

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 Threads inputs
Property Type Description
associatedContactId Associated Contact ID string
The ID of the contact to filter threads by
Optional Dynamic
association Association string
You can specify an association type here of TICKET. If this is set the response will included a thread associations object and associated ticket id if present. If there are no associations to a ticket with this conversation, then the thread associations object will not be present on the response.
Optional
archived Archived boolean
Whether to return only results that have been archived
Optional
inboxId Inbox ID string
The ID of the conversations inbox you can optionally include to retrieve the associated messages for. This parameter cannot be used in conjunction with the associatedContactId property.
Optional Dynamic
property Property string
A specific property to include in the thread response
Optional
after After string
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.
Optional
limit Limit integer
The maximum number of results to display per page
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-threads
Version
0.0.8
App
HubSpot
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes