View as Markdown
HubSpot icon

HubSpot ACTION

Send Message

Sends a message to a thread. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's HubSpot account once, then configure and run Send Message 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-send-message",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hubspot: { authProvisionId: "apn_xxxxxxx" },
    inboxId: "Inbox ID",
    senderActorId: "Sender Actor 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.

Send Message inputs
Property Type Description
inboxId Inbox ID string
The ID of an inbox
Required Dynamic
senderActorId Sender Actor ID string
The ID of the sender actor
Required Dynamic
channelId Channel ID string
The ID of a channel
Required Dynamic
threadId Thread ID string
The ID of a thread
Required Dynamic
channelAccountId Channel Account ID string
The ID of a channel account
Required Dynamic
recipientType Recipient Type string
The type of identifier. HS_EMAIL_ADDRESS for email addresses; HS_PHONE_NUMBER for a phone number; CHANNEL_SPECIFIC_OPAQUE_ID for channels that use their own proprietary identifiers, like Facebook Messenger or LiveChat. Use the "List Messages" action to locate a CHANNEL_SPECIFIC_OPAQUE_ID.
Required
recipientValue Recipient Value string
The value of the recipient identifier. For HS_EMAIL_ADDRESS, this is the email address. For HS_PHONE_NUMBER, this is the phone number. For CHANNEL_SPECIFIC_OPAQUE_ID, this is the proprietary identifier.
Required
text Text string
The text content of the message
Required
fileId File ID string
The ID of a file uploaded to HubSpot
Optional Dynamic
subject Subject string
The subject of the message
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-send-message
Version
0.0.8
App
HubSpot
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes