---
title: "メッセージの送信"
slug: "sens-sms-send"
updated: 2026-10-08T07:15:54Z
published: 2026-10-08T07:15:54Z
canonical: "api.ncloud-docs.com/sens-sms-send"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# メッセージの送信

Classic/VPC環境で利用できます。

SMS/LMS/MMSメッセージを送信します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /sms/v2/services/{serviceId}/messages |

### リクエストヘッダ

Simple & Easy Notification Service APIで共通して使用されるヘッダの詳細は、[Simple & Easy Notification Serviceのリクエストヘッダ](/docs/ja/sens-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `serviceId` | String | Required | SMSサービス ID - [プロジェクトリストの照会](/docs/ja/sens-project-list)を参照 |

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `type` | String | Required | メッセージタイプ - `SMS` \| `LMS` \| `MMS` - `SMS`: SMSメッセージ - `LMS`: LMSメッセージ - `MMS`: MMSメッセージ |
| `contentType` | String | Optional | メッセージコンテンツタイプ - `COMM` (デフォルト) \| `AD` - `COMM`: 一般用 - `AD`: 広告用 |
| `countryCode` | String | Optional | 国コード - `82` (デフォルト) - [国際 SMS送信国リスト](https://guide.ncloud-docs.com/docs/ja/sens-smspolicy)を参照 |
| `from` | String | Required | 送信番号 - コンソールを通じて登録された番号のみ使用可能 - [送信番号の登録](https://guide.ncloud-docs.com/docs/ja/sens-callingno#%EB%B0%9C%EC%8B%A0-%EB%B2%88%ED%98%B8-%EB%93%B1%EB%A1%9D)を参照 |
| `subject` | String | Optional | デフォルトのメッセージ件名(Byte) - 0~40 - LMS、MMSでのみ使用可能 |
| `content` | String | Required | デフォルトのメッセージ内容(Byte) - SMS: 0~90 - LMS、MMS: 0~2000 |
| `messages` | Array | Required | メッセージ情報: [messages](/docs/ja/sens-sms-send#messages) - 最大100件まで入力可能 |
| `files` | Array | Optional | 添付ファイルリスト: [files](/docs/ja/sens-sms-send#files) - MMSでのみ使用可能 - `type`で`MMS`を選択しても、添付ファイルがない場合は LMSとして送信 |
| `reserveTime` | String | Optional | 予約日時 - YYYY-MM-DD HH:mm形式 - 予約送信する場合、入力 |
| `reserveTimeZone` | String | Optional | 予約タイムゾーン - `Asia/Seoul` (デフォルト) - [タイムゾーンリスト](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)を参照 |

              参考

              

- サポート可能な最大サイズを超えると、一部の内容が切り捨てられて送信されます。
- メッセージの件名および内容のエンコードは EUC-KRベースで送信され、サポートしていない絵文字を含めると送信は失敗します。
- `messages`内の`subject`、`content`がデフォルトの`subject`、`content`より優先順位が高いです。
- MMSタイプなのに添付するファイルがない場合は LMSで送信されます。
- `reserveTime`現在の時刻から10分以内の場合、予約メッセージの登録はできません。

#### `messages`

`messages`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `to` | String | Required | 受信番号 - 数字のみ入力可能 |
| `subject` | String | Optional | 個々のメッセージ件名(Byte) - 0~40 - LMS、MMSでのみ使用可能 - 入力しないとデフォルトのメッセージ件名を適用 |
| `content` | String | Optional | 個々のメッセージ内容(Byte) - SMS: 0~90 - LMS、MMS: 0~2000 - 入力しないとデフォルトのメッセージ内容を適用 |

#### `files`

`files`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `fileId` | String | Required | 添付ファイル ID - [ファイルのアップロード](/docs/ja/sens-sms-attachment-create)を参照 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request POST 'https://sens.apigw.ntruss.com/sms/v2/services/ncp:sms:kr:50*********1:sens/messages' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
    "type": "MMS",
    "contentType": "COMM",
    "countryCode": "82",
    "from": "010********",
    "subject": "Delivery Notification",
    "content": "Hello. This is for notifying your delivery status.",
    "messages": [
        {
            "to": "010********",
            "subject": "Delivery Noti",
            "content": "Hello, ******. This is for notifying your delivery status."
        }
    ],
    "files": [
        {
            "fileId": "a136************************74f7"
        }
    ],
    "reserveTime": "2025-11-25 09:50",
    "reserveTimeZone": "Asia/Seoul"
}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `requestId` | String | - | リクエスト ID |
| `requestTime` | String | - | リクエスト日時 - YYYY-MM-DDTHH:mm:ss.sss形式 |
| `statusCode` | String | - | 状態コード - HTTPステータスコード規格に準拠 - `202`: 成功 - その他: 失敗 |
| `statusName` | String | - | 状態 - `success` \| `fail` - `success`: 成功 - `fail`: 失敗 |

### レスポンスステータスコード

Simple & Easy Notification Service APIで共通して使用されるレスポンスステータスコードの詳細は、[Simple & Easy Notification Serviceのレスポンスステータスコード](/docs/ja/sens-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
{
    "requestId": "RSLA-*************-****-********-IZJQgZEc",
    "requestTime": "2025-11-25T09:39:40.535",
    "statusCode": "202",
    "statusName": "success"
}
```