# Send SMS — RingCentral

> Creates and sends a new text message. See the API docs here

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

## Description

Creates and sends a new text message. See the API docs [here](https://developers.ringcentral.com/api-reference/SMS/createSMSMessage)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `accountId` | `string` | Yes | Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session. |
| `extensionId` | `string[]` | Yes | Internal identifier of an extension. Options are loaded from the connected account. |
| `fromPhoneNumber` | `string` | Yes | The phoneNumber for the sender of an SMS message. Property must be filled to correspond to one of the account phone numbers which is allowed to send SMS. Phone number in E.164 format e.g. +16502223366. |
| `toPhoneNumbers` | `string[]` | Yes | Phone number of receiver(s) of an SMS message. Phone number in E.164 format e.g. +16502223366. |
| `text` | `string` | Yes | Text of a message. Max length is 1000 symbols (2-byte UTF-16 encoded). If a character is encoded in 4 bytes in UTF-16 it is treated as 2 characters, thus restricting the maximum message length to 500 symbols. |
| `countryId` | `string` | No | Internal ID of a country. 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": "ringcentral",
      },
    },
  },
)

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: "ringcentral-send-sms",
  arguments: {
    accountId: "Account ID",
    extensionId: ["Extensions"],
  },
})
```

**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: "ringcentral-send-sms",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    ringcentral: { authProvisionId: "apn_xxxxxxx" },
    accountId: "Account ID",
    extensionId: ["Extensions"],
  },
})

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": "ringcentral-send-sms",
    "configured_props": {
      "ringcentral": { "authProvisionId": "apn_xxxxxxx" },
      "accountId": "Account ID",
      "extensionId": ["Extensions"]
    }
  }'
```

---

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