# Send SMS — SMS Everyone

> Send an SMS message or a bulk SMS campaign. See the documentation

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

## Description

Send an SMS message or a bulk SMS campaign. [See the documentation](https://www.smseveryone.com.au/restapi)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `originator` | `string` | Yes | Sender Number. Check the restrictions in your country as to whether you can use a word origin. If you send from a number, use international format without the + sign. |
| `destinations` | `string[]` | No | Phone number/s of the recipient/s. Ideally this should also be sent in international format without the + sign. |
| `message` | `string` | Yes | The message content. |
| `timescheduled` | `string` | No | If you're scheduling a message, include this field. Format: "YYYYMMDDHHMM" If you're sending now, this field is not necessary. If yuo set the date/time in the past, the SMS will be sent immediately. |
| `reference` | `string` | No | Your unique reference ID of the message. |
| `crmids` | `string[]` | No | The list ID of a list of mobile numbers that you want to send to. First you must upload the list to SMS Everyone interface and retrieve the list ID from SMS Everyone lists page. Options are loaded from the connected account. |

## 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": "sms_everyone",
      },
    },
  },
)

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: "sms_everyone-send-sms",
  arguments: {
    originator: "Originator",
    destinations: ["Destinations"],
  },
})
```

**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: "sms_everyone-send-sms",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    sms_everyone: { authProvisionId: "apn_xxxxxxx" },
    originator: "Originator",
    destinations: ["Destinations"],
  },
})

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": "sms_everyone-send-sms",
    "configured_props": {
      "sms_everyone": { "authProvisionId": "apn_xxxxxxx" },
      "originator": "Originator",
      "destinations": ["Destinations"]
    }
  }'
```

---

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