View as Markdown
Bandwidth icon

Bandwidth ACTION

Send SMS

Send an SMS message using Bandwidth's Messaging API
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Bandwidth account once, then configure and run Send SMS 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: "bandwidth-send-sms",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    bandwidth: { authProvisionId: "apn_xxxxxxx" },
    messageTo: "To",
    from: "From",
  },
})

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 SMS inputs
Property Type Description
messageTo To string
The number the message will be sent to, in E164 format ex +19195551234
Required
from From string
The number the call or message event will come from, in E164 format ex +19195551234
Required
message Message string
The text message content
Required
messagingApplicationId Messaging Application ID string

The ID from the messaging application created in the Bandwidth Dashboard.

The application must be associated with the location that the from number lives on.

Required

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
bandwidth-send-sms
Version
1.0.1
App
Bandwidth
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes