View as Markdown
Sendblue icon

Sendblue ACTION

Send Message

Send an iMessage or SMS to a specific phone number. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Sendblue 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: "sendblue-send-message",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    sendblue: { authProvisionId: "apn_xxxxxxx" },
    fromNumber: "Origin Phone Number",
    toNumber: "Recipient Phone Number",
  },
})

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
fromNumber Origin Phone Number string
The phone number to send from. Must be one of your registered Sendblue phone numbers in E.164 format. Without this parameter, the message will fail to send.
Required
toNumber Recipient Phone Number string
The phone number of the recipient in E.164 format (e.g., +12025551234)
Required
content Message Content string
The text content of the message to send
Optional
mediaUrl Media URL string
URL of media file to send (images, videos, etc.)
Optional
sendStyle Send Style string
The iMessage expressive message style (iMessage only)
Optional
statusCallback Status Callback string
Webhook URL for message status updates
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
sendblue-send-message
Version
0.0.1
App
Sendblue
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes