View as Markdown
Telnyx icon

Telnyx ACTION

Send Group Message

Send a group 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 Group 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-group-message",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    telnyx: { authProvisionId: "apn_xxxxxxx" },
    phoneNumber: "Phone Number",
    to: ["To"],
  },
})

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 Group Message inputs
Property Type Description
phoneNumber Phone Number string
The phone number to send the message from.
Optional Dynamic
to To string[]
Receiving list of destinations. No more than 8 destinations are allowed.
Required
text Text string
Message content. Must be a valid UTF-8 string, and no longer then 5MB for MMS.
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

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-group-message
Version
0.0.4
App
Telnyx
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes