# Send SMS — Altiria

> Send an SMS message. The message will be sent to the phone numbers you specify. See the documentation.

- Key: `altiria-send-sms`
- Type: Action (Write)
- Version: 0.0.2
- App: Altiria (`altiria`) — https://pipedream.com/apps/altiria.md
- This page (HTML): https://pipedream.com/apps/altiria/actions/send-sms
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/altiria/actions/send-sms/send-sms.mjs

## Description

Send an SMS message. The message will be sent to the phone numbers you specify. [See the documentation](https://static.altiria.com/especificaciones/altiria_push_rest.pdf).

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `destination` | `string[]` | Yes | 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. |
| `msg` | `string` | Yes | 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. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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",
  },
})
```

**TypeScript**

```ts
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**

```bash
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"
    }
  }'
```

---

- App: https://pipedream.com/apps/altiria.md · All apps: https://pipedream.com/apps