Altiria ACTION
Send SMS
Send an SMS message. The message will be sent to the phone numbers you specify. See the documentation.
- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Altiria 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: "altiria-send-sms",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
altiria: { authProvisionId: "apn_xxxxxxx" },
destination: ["Destination Phone Numbers"],
msg: "Message",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "altiria-send-sms",
"configured_props": {
"altiria": { "authProvisionId": "apn_xxxxxxx" },
"destination": ["Destination Phone Numbers"],
"msg": "Message"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "altiria",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "altiria-send-sms",
arguments: {
destination: ["Destination Phone Numbers"],
msg: "Message",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
destination Destination Phone Numbers | string[] | The phone numbers to which the message will be sent. Each number will be specified in international numbering format without the prefix 00 or the sign +. Eg: 34645852126. It is essential to include the country prefix (34 for Spain) so that the message reaches the expected destination. It must not exceed 16 digits. In any case, it is recommended not to exceed 100 phone numbers per request. Required |
msg Message | string | Message to send. The list of valid characters and the maximum allowed length is detailed in section 2.4 of the documentation. It cannot be empty (empty string). Mobile web identifiers can be added to generate unique shortened links in the message body. See section 2.5 for more details on mobile webs. 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
- altiria-send-sms
- Version
- 0.0.2
- App
- Altiria
- Authentication
- API key
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗