View as Markdown
Telnyx icon

Telnyx ACTION

Send Message

Send an SMS or MMS message. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Telnyx 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: "telnyx-send-message",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    telnyx: { authProvisionId: "apn_xxxxxxx" },
    messagingProfileId: "Messaging Profile Id",
    phoneNumber: "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
messagingProfileId Messaging Profile Id string
The Id of the messaging profile to use for sending the message.
Optional Dynamic
phoneNumber Phone Number string
The phone number to send the message from.
Optional Dynamic
to To string
Receiving address (+E.164 formatted phone number or short code).
Required
text Text string
Message content. Must be a valid UTF-8 string, and no longer than 1600 characters for SMS or 5MB for MMS. Required if sending an SMS message.
Optional
subject Subject string
Subject of the MMS message.
Optional
mediaUrls Media URLs string[]
URLs of media files to send with the message.
Optional
webhookUrl Webhook URL string
URL to send delivery receipts to. Must be a valid URL.
Optional
webhookFailoverUrl Webhook Failover URL string
URL to send delivery receipts to if the primary webhook fails. Must be a valid URL.
Optional
useProfileWebhooks Use Profile Webhooks boolean
Whether to use the messaging profile's webhook URL for delivery receipts.
Optional
type Type string
Type of message to sent.
Optional
autoDetect Auto Detect boolean
Automatically detect if an SMS message is unusually long and exceeds a recommended limit of message parts.
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
telnyx-send-message
Version
0.0.6
App
Telnyx
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes