Notification > SMS > API v2.4 Guide

v2.4 API Overview

Changes from v 2.3

  1. 각 메시지(단문, 장문, 인증) 발송 목록 검색 및 발송 단일 검색 응답 필드가 추가되었습니다.
    • 추가된 필드: messageType, recipientSeq
  2. 발송 단일 검색 조건에 사용되는 [mtPr]이 [recipientSeq]로 변경되었습니다.

[API Domain]

Environment Domain
Real https://api-sms.cloud.toast.com

[Caution]

  • Character lengths are supported as follows.
  • The maximum supported character counts are based on those saved; please write in standard specifications to prevent any text cutoff.
  • Delivery is made upon EUC-KR encoding and it fails for unsupported emoticons.
Category Maximum Support Standard Specifications
SMS Body 255 characters 90 bytes (45 characters for Korean, or 90 for English)
MMS Title 120 characters 40 bytes (20 characters for Korean, or 40 for English)
MMS Body 4,000 characters 2,000 bytes (1,000 characters for Korean, or 2,000 for English)

Short SMS

Send Short SMS

Request

[URL]

POST  /sms/v2.4/appKeys/{appKey}/sender/sms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "templateId": "TemplateId",
  "body": "Body",
  "sendNo": "15446859",
  "requestDate": "2018-08-10 10:00",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "countryCode": "82",
      "internationalRecipientNo": "821000000000",
      "templateParameter": {
        "key": "value"
      },
      "recipientGroupingKey": "recipientGroupingKey"
    }
  ],
  "userId": "UserId",
  "statsId": ""
}
Value Type Max Length Required Description
templateId String 50 X Delivery template ID
body String Standard: 90 bytes, Max: 255 characters (as of EUC-KR) [Precautions] O Body
sendNo String 13 O Sender number
requestDate String - X Request date and time (yyyy-MM-dd HH:mm)
Can be set up to 60 days from now
senderGroupingKey String 100 X Sender's group key
recipientList[].recipientNo String 20 O Recipient number
Available in combination with country code
Up to 1,000
recipientList[].countryCode String 8 X Country code [Default: 82 (Korea)]
recipientList[].internationalRecipientNo String 20 X Recipient number including country code
e.g.) 821012345678
To be ignored if recipientNo is available.
recipientList[].templateParameter Object - X Template parameter (with the input of template ID)
recipientList[].templateParameter.{key} String - X Replacement key (##key##)
recipientList[].templateParameter.{value} Object - X Value which is mapped for replacement key
recipientList[].recipientGroupingKey String 100 X Recipient group key
userId String 100 X Delivery delimiter e.g) admin,system
statsId String 10 X Statistics ID (not included in the delivery search conditions)

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/sms' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "body": "Body",
    "sendNo": "15446859",
    "recipientList": [{
            "internationalRecipientNo": "821000000000"
        }
    ]
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        }
      ]
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID
body.data.statusCode String Request status code (1:Requesting, 2:Request completed, 3:Request failed)
body.data.senderGroupingKey String Sender group key
body.data.sendResultList[].recipientNo String Recipient number
body.data.sendResultList[].resultCode Integer Result code
body.data.sendResultList[].resultMessage String Result message
body.data.sendResultList[].recipientSeq Integer Recipient sequence (mtPr)
body.data.sendResultList[].recipientGroupingKey String Recipient group key

Example of Sending Short SMS (general domestic recipient numbers)

Http metho URL
POST https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/sms

[Request body]

{
  "body": "Body",
  "sendNo": "15446859",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "recipientGroupingKey": "RecipientGroupingKey"
    },
    {
      "recipientNo": "01000000001",
      "recipientGroupingKey": "RecipientGroupingKey2"
    }
  ]
}

[Response]

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        },
        {
          "recipientNo": "01000000001",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 2,
          "recipientGroupingKey": "RecipientGroupingKey2"
        }
      ]
    }
  }
}

Example of Sending Short SMS (with country code included to recipient numbers)

Http metho URL
POST https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/sms

[Request body]

{
  "body": "Body",
  "sendNo": "15446859",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "internationalRecipientNo": "821000000000",
      "recipientGroupingKey": "RecipientGroupingKey"
    }
  ],
  "userId": "",
  "statsId": "statsId"
}

[Response]

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        }
      ]
    }
  }
}

List Delivery of Short SMS

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/sender/sms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

  • requestId or startRequestDate + endRequestDate or startCreateDate + endCreateDate is required.
  • To query registered date and sent date at the same time, sent date shall be ignored.
Value Type Max Length Required Description
requestId String 25 Required Request ID
startRequestDate String - Required Start date of delivery (yyyy-MM-dd HH:mm:ss)
endRequestDate String - Required End date of delivery (yyyy-MM-dd HH:mm:ss)
startCreateDate String - Required Start date of registration (yyyy-MM-dd HH:mm:ss)
endCreateDate String - Required End date of registration (yyyy-MM-dd HH:mm:ss)
startResultDate String - Optional Start date of receiving (yyyy-MM-dd HH:mm:ss)
endResultDate String - Optional End date of receiving (yyyy-MM-dd HH:mm:ss)
sendNo String 13 Optional Sender number
recipientNo String 20 Optional Recipient number
templateId String 50 Optional Template number
msgStatus String 1 Optional Message status code (0:Failed, 1: requesting, 2: processing, 3:successful, 4:Delivery Cancelled, 5:Duplicate Delivery, 6: Failed (Ad restricted), 7: Waiting for Resending (Ad restricted))
resultCode String 10 Optional Result code of receiving [Table on Query Codes]
subResultCode String 10 Optional Detail result code of receiving [Table on Query Codes]
senderGroupingKey String 100 Optional Sender's group key
recipientGroupingKey String 100 Optional Recipient's group key
pageNum Integer - Optional Page number (default : 1)
pageSize Integer 1000 Optional Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/sms?startRequestDate='"${START_DATE}"'&endRequestDate='"${END_DATE}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 1,
    "data": [
      {
        "requestId": "20180810100630ReZQ6KZzAH0",
        "requestDate": "2018-08-10 10:06:30.0",
        "resultDate": "2018-08-10 10:06:42.0",
        "templateId": "TemplateId",
        "templateName": "template name",
        "categoryId": 0,
        "categoryName": "category name",
        "body": "single-text test",
        "sendNo": "15446859",
        "countryCode": "82",
        "recipientNo": "01000000000",
        "msgStatus": "3",
        "msgStatusName": "successful",
        "resultCode": "1000",
        "resultCodeName": "successful",
        "telecomCode": 10001,
        "telecomCodeName": "SKT",
        "recipientSeq": 1,
        "sendType": "0",
        "messageType": "SMS",
        "userId": "tester",
        "adYn": "N",
        "resultMessage": "",
        "senderGroupingKey": "SenderGroupingKey",
        "recipientGroupingKey": "RecipientGroupingKey"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.pageNum Integer Current page number
body.pageSize Integer Number of queried data
body.totalCount Integer Number of total data
body.data[].requestId String Request ID
body.data[].requestDate String Date and time of sending
body.data[].resultDate String Date and time of receiving
body.data[].templateId String Template ID
body.data[].templateName String Template name
body.data[].categoryId Integer Category ID
body.data[].categoryName String Category name
body.data[].body String Body
body.data[].sendNo String Sender number
body.data[].countryCode String Country code
body.data[].recipientNo String Recipient number
body.data[].msgStatus String Message status code
body.data[].msgStatusName String Name of message status code
body.data[].resultCode String Result code of receiving [Table on Result Code of Receiving]
body.data[].resultCodeName String Result code name of receiving
body.data[].telecomCode Integer Code of telecom provider
body.data[].telecomCodeName String Name of telecom provider
body.data[].recipientSeq Integer Detail delivery ID (required to query details)
body.data[].sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data[].messageType String Message type (SMS/LMS/MMS/AUTH)
body.data[].userId String Delivery request ID
body.data[].adYn String Ad or not
body.data[].senderGroupingKey String Sender's group key
body.data[].recipientGroupingKey String Recipient's group key

Query Delivery of Short SMS

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/sender/sms/{requestId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
requestId String Request ID

[Query parameter]

Value Type Required Description
recipientSeq Integer Required Detail delivery ID

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/sms/'"${REQUEST_ID}"'?recipientSeq='"${RECIPIENT_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "requestDate": "2018-08-10 10:06:30.0",
      "resultDate": "2018-08-10 10:06:42.0",
      "templateId": "TemplateId",
      "templateName": "template name",
      "categoryId": 0,
      "categoryName": "Category name",
      "body": "body",
      "sendNo": "15446859",
      "countryCode": "82",
      "recipientNo": "01000000000",
      "msgStatus": "3",
      "msgStatusName": "successful",
      "resultCode": "1000",
      "resultCodeName": "successful",
      "telecomCode": 10001,
      "telecomCodeName": "SKT",
      "recipientSeq": 1,
      "sendType": "0",
      "messageType": "SMS",
      "userId": "tester",
      "adYn": "N",
      "resultMessage": "",
      "senderGroupingKey": "SenderGroupingKey",
      "recipientGroupingKey": "RecipientGroupingKey"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID
body.data.requestDate String Date and time of sending
body.data.resultDate String Date and time of receiving
body.data.templateId String Template ID
body.data.templateName String Template name
body.data.categoryId Integer Category ID
body.data.categoryName String Category name
body.data.body String Body
body.data.sendNo String Sender name
body.data.countryCode String Country code
body.data.recipientNo String Recipient number
body.data.msgStatus String Message status code
body.data.msgStatusName String Name of message status code
body.data.resultCode String Result code of receiving [Table on Result Code of Receiving]
body.data.resultCodeName String Result code name of receiving
body.data.telecomCode Integer Telecom provider code
body.data.telecomCodeName String Telecom provider name
body.data.recipientSeq Integer Detail delivery ID (required to query details)
body.data.sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data.messageType String Message type (SMS/LMS/MMS/AUTH)
body.data.userId String Delivery request ID
body.data.adYn String Ad or not
body.data.senderGroupingKey String Sender's group key
body.data.recipientGroupingKey String Recipient's group key

Long MMS

Send Long MMS (attached file excluded)

Request

[URL]

POST  /sms/v2.4/appKeys/{appKey}/sender/mms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "templateId": "TemplateId",
  "title": "Title",
  "body": "Body",
  "sendNo": "15446859",
  "requestDate": "2018-08-10 10:00",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "countryCode": "82",
      "internationalRecipientNo": "821000000000",
      "templateParameter": {
        "key": "value"
      },
      "recipientGroupingKey": "recipientGroupingKey"
    }
  ],
  "userId": "UserId",
  "statsId": "statsId"
}
Value Type Maximum Length Required Description
templateId String 50 X Delivery template ID
title String 40 bytes (in EUC-KR) O Title
body String 2000 bytes (in EUC-KR) O Body
sendNo String 13 O Sender number
requestDate String - X Request date and time(yyyy-MM-dd HH:mm)
Can be set up to 60 days from now
senderGroupingKey String 100 X Sender's group key
recipientList[].recipientNo String 20 O Recipient number
Available in combination of countryCode
recipientList[].countryCode String 8 X Country code [Default: 82 (Korea)]
recipientList[].internationalRecipientNo String 20 X Recipient number including country code
e.g.) 821012345678
To be ignored if recipientNo is available.
recipientList[].templateParameter Object - X Template parameter (with the input of template ID)
recipientList[].templateParameter.{key} String - X Replacement key (##key##)
recipientList[].templateParameter.{value} Object - X Value which is mapped for replacement key
recipientList[].recipientGroupingKey String 1000 X Recipient group key
userId String 100 X Delivery delimiter e.g.) admin,system
statsId String 10 X Statistics ID (not included in the delivery search conditions)

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/mms' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "title": "{title}",
    "body": "{body}",
    "sendNo": "15446859",
    "attachFileIdList": [0],
    "recipientList": [{
            "recipientNo": "01000000000",
            "templateParameter": {}
        }
    ],
    "userId": ""
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        }
      ]
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID
body.data.statusCode String Request status code (1: requesting, 2:request completed, 3: request failed)
body.data.senderGroupingKey String Sender's group key
body.data.sendResultList[].recipientNo String Recipient number
body.data.sendResultList[].resultCode Integer Result code
body.data.sendResultList[].resultMessage String Result message
body.data.sendResultList[].recipientSeq Integer Recipient sequence (mtPr)
body.data.sendResultList[].recipientGroupingKey String Recipient's group key

Example of Sending Long MMS

Http metho URL
POST https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/mms

[Request body]

{
  "title": "Title",
  "body": "Body",
  "sendNo": "15446859",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "recipientGroupingKey": "RecipientGroupingKey"
    },
    {
      "recipientNo": "01000000001",
      "recipientGroupingKey": "RecipientGroupingKey2"
    }
  ]
}

[Response]

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        },
        {
          "recipientNo": "01000000001",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 2,
          "recipientGroupingKey": "RecipientGroupingKey2"
        }
      ]
    }
  }
}

Send MMS (attached file included)

Example of Sending Attached Files

Http method URL
POST https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/mms

[Request body]

{
  "title": "Title",
  "body": "Body",
  "sendNo": "15446859",
  "senderGroupingKey": "SenderGrouping",
  "attachFileIdList": [
    0
  ],
  "recipientList": [
    {
      "recipientNo": "01010000000",
      "recipientGroupingKey": "RecipientGroupingKey"
    }
  ]
}

[Response]

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGrouping",
      "sendResultList": [
        {
          "recipientNo": "01012341234",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        }
      ]
    }
  }
}
Description
  • To deliver long MMS including attached files (field name: attachFileIdList), attached files must be uploaded first.
  • See guides for [Upload Attachment] .
  • Restrictions for Attached Images
    • Supported Codec: .jpg, .jpeg
    • Number of Attached Images: 3 or less
    • Size of Attached Image: Less than 300KB per image. But, less than 8000KB in total if the number of attached images is 3
    • Resolution of Image: Less than 1000*1000

List Delivery of Long MMS Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/sender/mms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

  • requestId or startRequestDate + endRequestDate or startCreateDate + endCreateDate is required.
  • To query registered date and sent date at the same time, sent date shall be ignored.
Value Type Max Length Required Description
requestId String 25 Required Request ID
startRequestDate String - Required Start date of sending (yyyy-MM-dd HH:mm:ss)
endRequestDate String - Required End date of sending (yyyy-MM-dd HH:mm:ss)
startCreateDate String - Required Start date of registration (yyyy-MM-dd HH:mm:ss)
endCreateDate String - Required End date of registration (yyyy-MM-dd HH:mm:ss)
startResultDate String - Optional Start date of receiving (yyyy-MM-dd HH:mm:ss)
endResultDate String - Optional End date of receiving (yyyy-MM-dd HH:mm:ss)
sendNo String 13 Optional Sender number
recipientNo String 20 Optional Recipient numbe
templateId String 50 Optional Template number
msgStatus String 1 Optional Message status code (0:Failed, 1: requesting, 2: processing, 3:successful, 4:Delivery Cancelled, 5:Duplicate Delivery, 6: Failed (Ad restricted), 7: Waiting for Resending (Ad restricted))
resultCode String 10 Optional Result code of receiving [Table on Query Codes]
subResultCode String 10 Optional Detail result code of receiving [Table on Query Codes]
senderGroupingKey String 100 Optional Sender's group key
recipientGroupingKey String 100 Optional Recipient's group key
pageNum Integer - Optional Page number (default : 1)
pageSize Integer 1000 Optional Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/mms?startRequestDate='"${START_DATE}"'&endRequestDate='"${END_DATE}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 1,
    "data": [
      {
        "requestId": "20230918160734BWt01iOWZm2",
        "requestDate": "2023-09-18 16:07:34.0",
        "resultDate": "2023-09-18 16:07:36.0",
        "templateId": null,
        "templateName": null,
        "categoryId": null,
        "categoryName": null,
        "title": "Title",
        "body": "본문",
        "sendNo": "15771234",
        "countryCode": "82",
        "recipientNo": "01012341234",
        "msgStatus": "3",
        "msgStatusName": "성공",
        "resultCode": "1000",
        "resultCodeName": "성공",
        "telecomCode": 10003,
        "telecomCodeName": "LGU",
        "mtPr": "1",
        "sendType": "1",
        "userId": null,
        "adYn": "N",
        "attachFileList": [
          {
            "fileId": 535191,
            "filePath": "/temporary/71191/toast-mt-2023-09-18/1607/535191/",
            "fileName": "attachment.jpg",
            "saveFileName": "20230918KKkqQC0.jpg",
            "uploadType": "TEMPORARY"
          }
        ],
        "resultMessage": "SUCCESS",
        "senderGroupingKey": "SenderGroupingKey",
        "recipientGroupingKey": "recipientGroupingKey"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body Object Body area
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data[].requestId String Request ID
body.data[].requestDate String Date and time of request
body.data[].resultDate String Date and time of receiving
body.data[].templateId String Template ID
body.data[].templateName String Template name
body.data[].categoryId Integer Category ID
body.data[].categoryName String Category name
body.data[].body String Body message
body.data[].sendNo String Sender number
body.data[].countryCode String Country code
body.data[].recipientNo String Recipient number
body.data[].msgStatus String Message status code
body.data[].msgStatusName String Name of message status code
body.data[].resultCode String Result code of receiving [Table on Result Code of Receiving]
body.data[].resultCodeName String Result code name of receiving
body.data[].telecomCode Integer Code of telecom provider
body.data[].telecomCodeName String Name of telecom provider
body.data[].recipientSeq Integer Detail delivery ID (required to query details)
body.data[].sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data[].messageType String Message type (SMS/LMS/MMS/AUTH)
body.data[].userId String Delivery request ID
body.data[].adYn String Ad or not
body.data[].attachFileList[].fileId Integer File ID
body.data[].attachFileList[].filePath String Path of file saving (for internal purpose)
body.data[].attachFileList[].fileName String File name
body.data[].attachFileList[].saveFileName String Name of saved file
body.data[].attachFileList[].uploadType String Type of uploaded
body.data[].senderGroupingKey String Sender's group key
body.data[].recipientGroupingKey String Recipient's group key

Query Single Delivery of Long MMS

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/sender/mms/{requestId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Origional appkey
requestId String Request ID

[Query parameter]

Value Type Required Description
recipientSeq Integer Required Detail delivery ID

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/mms/'"${REQUEST_ID}"'?recipientSeq='"${RECIPIENT_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "requestId": "20230918160734BWt01iOWZm2",
      "requestDate": "2023-09-18 16:07:34.0",
      "resultDate": "2023-09-18 16:07:36.0",
      "templateId": null,
      "templateName": null,
      "categoryId": null,
      "categoryName": null,
      "title": "Title",
      "body": "본문",
      "sendNo": "15771234",
      "countryCode": "82",
      "recipientNo": "01012341234",
      "msgStatus": "3",
      "msgStatusName": "성공",
      "resultCode": "1000",
      "resultCodeName": "성공",
      "telecomCode": 10003,
      "telecomCodeName": "LGU",
      "mtPr": "1",
      "sendType": "1",
      "userId": null,
      "adYn": "N",
      "attachFileList": [
        {
          "fileId": 535191,
          "filePath": "/temporary/71191/toast-mt-2023-09-18/1607/535191/",
          "fileName": "attachment.jpg",
          "saveFileName": "20230918KKkqQC0.jpg",
          "uploadType": "TEMPORARY"
        }
      ],
      "resultMessage": "SUCCESS",
      "senderGroupingKey": "SenderGroupingKey",
      "recipientGroupingKey": "recipientGroupingKey"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body Object Body area
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data[].requestId String Request ID
body.data[].requestDate String Date and time of sending
body.data[].resultDate String Date and time of receiving
body.data[].templateId String Template ID
body.data[].templateName String Template name
body.data[].categoryId Integer Category ID
body.data[].categoryName String Category name
body.data[].body String Body message
body.data[].sendNo String Sender number
body.data[].countryCode String Country code
body.data[].recipientNo String Recipient number
body.data[].msgStatus String Message status code
body.data[].msgStatusName String Name of message status code
body.data[].resultCode String Result code of receiving [Table on Result Code of Receiving]
body.data[].resultCodeName String Result code name of receiving
body.data[].telecomCode Integer Code of telecom provider
body.data[].telecomCodeName String Name of telecome provider
body.data[].recipientSeq Integer Detail delivery ID (required to query details)
body.data[].sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data[].messageType String Message type (SMS/LMS/MMS/AUTH)
body.data[].userId String Delivery request ID
body.data[].adYn String Ad or not
body.data[].attachFileList[].fileId Integer File ID
body.data[].attachFileList[].filePath String Path of file saving (for internal purpose)
body.data[].attachFileList[].fileName String File name
body.data[].attachFileList[].saveFileName String Name of saved file
body.data[].attachFileList[].uploadType String Type of uploaded
body.data[].senderGroupingKey String Sender's group key
body.data[].recipientGroupingKey String Recipient's group key

SMS for Authentication (emergency)

Send SMS for Authentication

  1. Guide for authentication words required to be included for sending authentication SMS
Category Authentication Words
Authentication SMS (for emergency) auth, password, verif, にんしょう, 認証, 비밀번호, 인증
  • Example 1) Delivery shall fail if the full text (including template replacement) does not include authentication words, in the request of Send Authentication SMS API (for emergency)
  • Example 2) Validity for English words shall be checked regardless of small or capital letters

Request

[URL]

POST  /sms/v2.4/appKeys/{appKey}/sender/auth/sms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "templateId": "TemplateId",
  "body": "body",
  "sendNo": "15446859",
  "requestDate": "2018-08-10 10:00",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "countryCode": "82",
      "internationalRecipientNo": "821000000000",
      "templateParameter": {
        "key": "value"
      },
      "recipientGroupingKey": "recipientGroupingKey"
    }
  ],
  "userId": "UserId",
  "statsId": "statsId"
}
Value Type Max Length Required Description
templateId String 50 X Delivery template ID
body String Standard: 90 bytes, Max: 255 characters (as of EUC-KR) [Precautions] O Body [Precautions]
sendNo String 13 O Sender number
requestDate String - X Date and time of schedule (yyyy-MM-dd HH:mm)
Can be set up to 60 days from now
senderGroupingKey String 100 X Sender's group key
recipientList[].recipientNo String 20 O Recipient number
Available in combination of the country code
recipientList[].countryCode String 8 X Country code [default: 82 (Korea)]
recipientList[].internationalRecipientNo String 20 X Recipient number including country code
e.g.) 821012345678
To be ignored if recipientNo is available
recipientList[].templateParameter Object - X Template parameter (with the input of template ID)
recipientList[].templateParameter.{key} String - X Replacement key (##key##)
recipientList[].templateParameter.{value} Object - X Value which is mapped for replacement key
recipientList[].recipientGroupingKey String 100 X Recipient's group key
userId String 100 X Delivery delimiter e.g.) admin,system
statsId String 10 X Statistics ID (not included in the delivery search conditions)

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/auth/sms' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "body": "인증 테스트",
    "sendNo": "15446859",
    "recipientList": [{
            "recipientNo": "01000000000",
            "templateParameter": {}
        }
    ],
    "userId": ""
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        }
      ]
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID
body.data.statusCode String Request status code (1: Requesting, 2: Request completed, 3: Request failed)
body.data.senderGroupingKey String Sender's group key
body.data.sendResultList[].recipientNo String Recipient number
body.data.sendResultList[].resultCode Integer Result code
body.data.sendResultList[].resultMessage String Result message
body.data.sendResultList[].recipientSeq Integer Recipient sequence (mtPr)
body.data.sendResultList[].recipientGroupingKey String Recipient's group key

Example

Http metho URL
POST https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/auth/sms

[Request body]

{
  "body": "body",
  "sendNo": "15446859",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "recipientGroupingKey": "RecipientGroupingKey"
    },
    {
      "recipientNo": "01000000001",
      "recipientGroupingKey": "RecipientGroupingKey2"
    }
  ]
}

[Response]

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        },
        {
          "recipientNo": "01000000001",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 2,
          "recipientGroupingKey": "RecipientGroupingKey2"
        }
      ]
    }
  }
}

List SMS Delivery for Authentication

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/sender/auth/sms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

  • requestId or startRequestDate + endRequestDate or startCreateDate + endCreateDate is required.
  • To query registered date and sent date at the same time, sent date shall be ignored.
Value Type Max Length Required Description
requestId String 25 Required Request ID
startRequestDate String - Required Start date of sending (yyyy-MM-dd HH:mm:ss)
endRequestDate String - Required End date of sending (yyyy-MM-dd HH:mm:ss)
startCreateDate String - Required Start date of registration (yyyy-MM-dd HH:mm:ss)
endCreateDate String - Required End date of registration (yyyy-MM-dd HH:mm:ss)
startResultDate String - Optional Start date of receiving (yyyy-MM-dd HH:mm:ss)
endResultDate String - Optional End date of receiving (yyyy-MM-dd HH:mm:ss)
sendNo String 13 Optional Sender number
recipientNo String 20 Optional Recipient number
templateId String 50 Optional Template number
msgStatus String 1 Optional Message status code (0:Failed, 1: requesting, 2: processing, 3:successful, 4:Delivery Cancelled, 5:Duplicate Delivery, 6: Failed (Ad restricted), 7: Waiting for Resending (Ad restricted))
resultCode String 10 Optional Result code of receiving [Table on Query Codes]
subResultCode String 10 Optional Detail result code of receiving [Table on Query Codes]
senderGroupingKey String 100 Optional Sender's group key
recipientGroupingKey String 100 Optional Recipient's group key
pageNum Integer - Optional Page number (Default : 1)
pageSize Integer 1000 Optional Number of queries (Default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/auth/sms?startRequestDate='"${START_DATE}"'&endRequestDate='"${END_DATE}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 1,
    "data": [
      {
        "requestId": "20180810100630ReZQ6KZzAH0",
        "requestDate": "2018-08-10 10:06:30.0",
        "resultDate": "2018-08-10 10:06:42.0",
        "templateId": "TemplateId",
        "templateName": "template name",
        "categoryId": 0,
        "categoryName": "category name",
        "body": "single text test",
        "sendNo": "15446859",
        "countryCode": "82",
        "recipientNo": "01000000000",
        "msgStatus": "3",
        "msgStatusName": "successful",
        "resultCode": "1000",
        "resultCodeName": "successful",
        "telecomCode": 10001,
        "telecomCodeName": "SKT",
        "recipientSeq": 1,
        "sendType": "0",
        "messageType": "AUTH",
        "userId": "tester",
        "adYn": "N",
        "resultMessage": "",
        "senderGroupingKey": "SenderGroupingKey",
        "recipientGroupingKey": "RecipientGroupingKey"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data[].requestId String Request ID
body.data[].requestDate String Date and time of sending
body.data[].resultDate String Date and time of receiving
body.data[].templateId String Template ID
body.data[].templateName String Template name
body.data[].categoryId Integer Category ID
body.data[].categoryName String Category name
body.data[].body String Body message
body.data[].sendNo String Sender number
body.data[].countryCode String Country code
body.data[].recipientNo String Recipient number
body.data[].msgStatus String Message status code
body.data[].msgStatusName String Name of message status code
body.data[].resultCode String Result code of receiving [Table on Result Code of Receiving]
body.data[].resultCodeName String Result code name of receiving
body.data[].telecomCode Integer Code of telecom provider
body.data[].telecomCodeName String Name of telecom provider
body.data[].recipientSeq Integer Detail delivery ID (required to query details)
body.data[].sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data[].messageType String Message type (SMS/LMS/MMS/AUTH)
body.data[].userId String Request ID for sending
body.data[].adYn String Ad or not
body.data[].senderGroupingKey String Sender's group key
body.data[].recipientGroupingKey String Recipient's group key

Query Single SMS Delivery for Authentication

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/sender/auth/sms/{requestId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
requestId String Request ID

[Query parameter]

Value Type Required Description
recipientSeq Integer Required Detail delivery ID

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/auth/sms/'"${REQUEST_ID}"'?recipientSeq='"${RECIPIENT_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "requestId": "20180810100630ReZQ6KZzAH0",
      "requestDate": "2018-08-10 10:06:30.0",
      "resultDate": "2018-08-10 10:06:42.0",
      "templateId": "TemplateId",
      "templateName": "template name",
      "categoryId": 0,
      "categoryName": "category name",
      "body": "body",
      "sendNo": "15446859",
      "countryCode": "82",
      "recipientNo": "01000000000",
      "msgStatus": "3",
      "msgStatusName": "successful",
      "resultCode": "1000",
      "resultCodeName": "successful",
      "telecomCode": 10001,
      "telecomCodeName": "SKT",
      "recipientSeq": 1,
      "sendType": "0",
      "messageType": "AUTH",
      "userId": "tester",
      "adYn": "N",
      "resultMessage": "",
      "senderGroupingKey": "SenderGroupingKey",
      "recipientGroupingKey": "RecipientGroupingKey"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Requst ID
body.data.requestDate String Date and time of sending
body.data.resultDate String Date and time of receiving
body.data.templateId String Template ID
body.data.templateName String Template name
body.data.categoryId Integer Category ID
body.data.categoryName String Category name
body.data.body String Body message
body.data.sendNo String Sender number
body.data.countryCode String Country code
body.data.recipientNo String Recipient number
body.data.msgStatus String Message status code
body.data.msgStatusName String Name of message status code
body.data.resultCode String Result code of receiving [Table on result code of receiving]
body.data.resultCodeName String Result code name of receiving
body.data.telecomCode Integer Code of telecom provider
body.data.telecomCodeName String Name of telecom provider
body.data.recipientSeq Integer Detail delivery ID (required to query details)
body.data.sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data.messageType String Message type (SMS/LMS/MMS/AUTH)
body.data.userId String Request ID for sending
body.data.adYn String Ad or not
body.data.senderGroupingKey String Sender's group key
body.data.recipientGroupingKey String Recipient's group key

Ad Messages

Send SMS for Advertisement

[URL]

POST  /sms/v2.4/appKeys/{appKey}/sender/ad-sms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request Body] Same as Send SMS in the above. [See Request Body]

However, required statements for ads must be included in the body.

080 numbers are available in Setting for Rejection of Receiving 080 Numbers on console.

Required statements for ads are as follows. - Opening statement: (Ads) - Last statement: Deny for free {080-unsubscribed-number} or Deny for free {080-unsubscribed-number} (the phrase can include spaces).

Example

(Ads)
[Deny for free]080XXXXXXX
(Ad)

[Deny for free]080XXXXXXX

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/ad-sms' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "body": "(광고) Test\n [무료 수신 거부]0808880327",
    "sendNo": "15446859",
    "recipientList": [{
            "recipientNo": "01000000000",
            "templateParameter": {}
        }
    ],
    "userId": ""
}'

Send MMS for Advertisement

[URL]

POST  /sms/v2.4/appKeys/{appKey}/sender/ad-mms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request Body] Same as Send MMS in the above. [See Request Body]

However, required statements for ads must be included in the body.

080 numbers are available in Setting for Rejection of Receiving 080 Numbers on console.

Required statements for ads are as follows. - Opening statement: (Ads) - Last statement: Deny for free {080-unsubscribed-number} or Deny for free {080-unsubscribed-number} (the phrase can include spaces).

Example

(Ads)
[Deny for free]080XXXXXXX
(Ad)

[Deny for free]080XXXXXXX

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/ad-mms' \
-H 'Content-Type: application/json;charset=UTF-8'
-d '{
    "title": "{제목}",
    "body": "(광고) 테스트\n [무료 수신 거부]0808880327",
    "sendNo": "15446859",
    "recipientList": [{
            "recipientNo": "01000000000",
            "templateParameter": {}
        }
    ],
    "userId": ""
}'

Query Messages by Result Updates

  • The API is queried as of the update time of message delivery result.
  • Please apply this API to import delivery results on device from service.

Query Messages

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/message-results?startUpdateDate={startUpdateDate}&endUpdateDate={endUpdateDate}&messageType={messageType}&pageNum={pageNum}&pageSize={pageSize}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

  • The range between search start time and search end time is limited to one day.
Value Type Required Description
startUpdateDate String Required Start time of query result updates
yyyy-MM-dd HH:mm:ss
endUpdateDate String Required End time of query result updates
yyyy-MM-dd HH:mm:ss
messageType String Optional Message type (SMS/LMS/MMS/AUTH)
pageNum Integer Optional Page number (default:1)
pageSize Integer Optional Number of queries (default:15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/message-results?startRequestDate='"${START_DATE}"'&endRequestDate='"${END_DATE}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 35,
    "data": [
      {
        "messageType": "SMS",
        "requestId": "20230914101505oAJTbxHkIB0",
        "recipientSeq": 1,
        "resultCode": "1000",
        "resultCodeName": "성공",
        "requestDate": "2023-09-14 10:15:05.0",
        "resultDate": "2023-09-14 10:15:08.0",
        "updateDate": "2023-09-14 10:15:12.0",
        "telecomCode": "10002",
        "telecomCodeName": "KT",
        "senderGroupingKey": "SenderGroupingKey",
        "recipientGroupingKey": "recipientGroupingKey"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.resultUpdateList[].messageType String Message type (SMS/LMS/MMS/AUTH)
body.data.resultUpdateList[].requestId String Request ID
body.data.resultUpdateList[].recipientSeq Integer Recipient sequence
body.data.resultUpdateList[].resultCode String Result code
body.data.resultUpdateList[].resultCodeName String Name of result code
body.data.resultUpdateList[].requestDate String Date and time of request (yyyy-MM-dd HH:mm:ss.S)
body.data.resultUpdateList[].resultDate String Date and time of receiving (yyyy-MM-dd HH:mm:ss.S)
body.data.resultUpdateList[].updateDate String Date and time of result updates (yyyy-MM-dd HH:mm:ss.S)
body.data.resultUpdateList[].telecomCode String Code of telecom provider
body.data.resultUpdateList[].telecomCodeName String Name of telecom provider
body.data.resultUpdateList[].senderGroupingKey String Sender's group key
body.data.resultUpdateList[].recipientGroupingKey String Recipient's group key

Tag Delivery

Send Tagged SMS

Request

[URL]

POST /sms/v2.4/appKeys/{appKey}/tag-sender/sms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "body": "body",
  "sendNo": "15446859",
  "requestDate": "2018-03-22 10:00",
  "templateId": "TemplateId",
  "templateParameter": {
    "key": "value"
  },
  "tagExpression": [
    "tag1",
    "AND",
    "tag2"
  ],
  "userId": "user_id",
  "adYn": "N",
  "autoSendYn": "N",
  "statsId": "statsId"
}
Value Type Max Length Required Description
body String Standard: 90 bytes, Max: 255 characters (as of EUC-KR) [Precautions] O Body
sendNo String 13 O Sender number
requestDate String - X Date and time of schedule (yyyy-MM-dd HH:mm)
Can be set up to 60 days from now
templateId String 50 X Template ID
templateParameter Map - X Template parameter
tagExpression List - O Tag expression
ex) ["tagA","AND","tabB"]
userId String 100 X Requester ID
adYn String 1 X Ad or not (default: N)
autoSendYn String 1 X Auto delivery or not (immediate delivery) (default: Y)
statsId String 10 X Statistics ID (not included in the delivery search conditions)

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tag-sender/sms' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "body": "본문",
    "sendNo": "15446859",
    "templateParameter": {
        "key": "value"
    },
    "tagExpression": ["TsNuyRPF"],
    "userId": "user_id",
    "adYn": "N",
    "autoSendYn": "N",
    "statsId": "statsId"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "201808130914102Y94ABMNF30"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID

Send Tagged LMS

Request

[URL]

POST  /sms/v2.4/appKeys/{appKey}/tag-sender/mms
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "body": "body",
  "sendNo": "15446859",
  "requestDate": "2018-03-22 10:00",
  "templateId": "TemplateId",
  "templateParameter": {
    "key": "value"
  },
  "attachFileIdList": [
    1,
    2,
    3
  ],
  "tagExpression": [
    "tag1",
    "AND",
    "tag2"
  ],
  "userId": "user_id",
  "adYn": "N",
  "autoSendYn": "N",
  "statsId": "statsId"
}
Value Type Max Length Required Description
title String 40 bytes (in EUC-KR) O Title of text
body String 2000 bytes (in EUC-KR) O Body message
sendNo String 13 O Sender number
requestDate String - X Date and time of schedule (yyyy-MM-dd HH:mm)
Can be set up to 60 days from now
templateId String 50 X Template ID
templateParameter Map - X Template parameter
tagExpression List - O Tax expression
ex) ["tagA","AND","tabB"]
attachFileIdList List - X Attached file ID (fileId)
userId String 100 X Requester ID
adYn String 1 X Ad or not (default: N)
autoSendYn String 1 X Auto delivery or not (immediate delivery) (default: Y)
statsId String 10 X Statistics ID (not included in the delivery search conditions)

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tag-sender/mms' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "title": "제목",
    "body": "본문",
    "sendNo": "15446859",
    "templateParameter": {
        "key": "value"
    },
    "tagExpression": ["TsNuyRPF"],
    "userId": "user_id",
    "adYn": "N",
    "autoSendYn": "Y"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "201808130914102Y94ABMNF30"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID

List Tag Delivery

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/tag-sender

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

  • requestId or startRequestDate + endRequestDate or startCreateDate + endCreateDate is required.
  • To query registered date and sent date at the same time, sent date shall be ignored.
Value Type Max Length Required Description
appKey String - O appkey
sendType required, String 1 O Delivery Type
SMS : "0",
MMS : "1"
requestId String - O Request ID
startRequestDate String - O Start date of delivery
endRequestDate String - O End date of delivery
startCreateDate String - O Start date of registration
endCreateDate String - O End date of registration
statusCode String 10 X Delivery status code
WAIT : "MAS00"
READY : "MAS01"
SENDREADY : "MAS09"
SENDWAIT : "MAS10"
SENDING : "MAS11"
COMPLETE : "MAS19"
CANCELING : "MAS90"
CANCEL : "MAS91"
FAIL : "MAS99"
pageNum optional, Integer - X Page number
pageSize optional, Integer 1000 X Number of queries

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tag-sender?requestId='"${REQUEST_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "success"
  },
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "totalCount": 0,
    "data": [
      {
        "requestId": "20171220141558eonMsyDI6P0",
        "requestIp": "127.0.0.1",
        "sendType": "0",
        "templateId": "TemplateId",
        "templateName": "template name",
        "masterStatusCode": "READY",
        "sendNo": "15446859",
        "requestDate": "2017-12-20 14:15:58",
        "tagExpression": [
          "Kb6BjCY1"
        ],
        "title": "title",
        "body": "body",
        "adYn": "N",
        "autoSendYn": "Y",
        "sendErrorCount": 0,
        "createUser": "CreateUser",
        "createDate": "2017-12-20 14:15:58.0",
        "updateUser": "UpdateUser",
        "updateDate": "2017-12-20 14:15:58.0"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data[].requestId String Request ID
body.data[].requestIp String Request IP
body.data[].requestDate String Request time
body.data[].tagSendStatus String Tag delivery status
body.data[].tagExpression[] List Tag expression
body.data[].templateId String Template ID
body.data[].templateName String Template name
body.data[].senderName String Sender's name
body.data[].senderMail String Sender's address
body.data[].title String Title
body.data[].body String Body
body.data[].adYn String Ad or not
body.data[].autoSendYn String Auto delivery or not
body.data[].sendErrorCount Integer Error counts in recipients
body.data[].createUser String Creator
body.data[].createDate String Date and time of creation
body.data[].updateUser String Modifier
body.data[].updateDate String Date and time of modification

List Recipients of Tag Delivery

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/tag-sender/{requestId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
requestId String Request ID

[Query parameter]

  • requestId or startRequestDate + endRequestDate is required.
Value Type Max Length Required Description
recipientNum String 20 X Recipient number
startRequestDate String - O Start date of delivery request
endRequestDate String - O End date of delivery request
startResultDate String - X Start date of receiving
endResultDate String - X End date of receiving
msgStatusName String 10 X Message status code
- READY: Ready
- SENDING: Requesting for delivery
- COMPLETED : Request for delivery completed
- FAILED : Delivery failed
resultCode String 10 X Result code of receiving
pageNum Integer - X Page number
pageSize Integer 1000 X Number of queries

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tag-sender/'"${REQUEST_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "success"
  },
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "totalCount": 0,
    "data": [
      {
        "requestId": "20180813022044Jps2xJ1qsv0",
        "recipientSeq": 99,
        "countryCode": "82",
        "recipientNo": "01000000000",
        "requestDate": "2018-08-13 02:20:44.0",
        "msgStatus": "3",
        "msgStatusName": "COMPLETED",
        "resultCode": "3015",
        "receiveDate": "2018-08-13 02:20:53.0",
        "createDate": "2018-08-13 02:20:46.0",
        "updateDate": "2018-08-13 02:27:00.0"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID
body.data.recipientSeq Integer Recipient sequence
body.data.countryCode String Recipient's country code
body.data.recipientNo String Recipient number
body.data.requestDate String Date and time of request
body.data.msgStatus String Message status code
body.data.msgStatusName String Name of message status code
body.data.resultCode String Result code of receiving [Table on result code of receiving]
body.data.receiveDate String Date and time of receiving
body.data.createDate String Date and time of registration
body.data.updateDate String Date of modification

List Recipient Details of Tagged Delivery

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/tag-sender/{requestId}/{recipientSeq}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
requestId String Request ID
recipientSeq String Sequence

[Request body]

X

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tag-sender/'"${REQUEST_ID}"'/'"${RECIPIENT_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "requestId": "20180813022044Jps2xJ1qsv0",
      "recipientSeq": 14,
      "sendType": "0",
      "messageType": "SMS",
      "templateId": "TemplateId",
      "templateName": "template name",
      "sendNo": "15446859",
      "recipientNum": "01000000000",
      "countryCode": "82",
      "title": "title",
      "body": "body",
      "requestDate": "2018-08-13 02:20:44.0",
      "msgStatusName": "COMPLETED",
      "msgStatus": "3",
      "resultCode": "3015",
      "receiveDate": "2018-08-13 02:20:48.0",
      "attachFileList": []
    }
  }
}
Value Type Description
header Object Header area
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestId String Request ID
body.data.recipientSeq Integer Recipient sequence
body.data.sendType String Delivery type
body.data.messageType String Message type
body.data.templateId String Template ID
body.data.templateName String Template name
body.data.sendNo String Sender number
body.data.title String Title
body.data.body String Body
body.data.recipientNum String Recipient number
body.data.requestDate String Date and time of request
body.data.msgStatusName String Message status name
body.data.resultCode String Result code of receiving [Table on result code of receiving]
body.data.receiveDate String Date and time of receiving
body.data.attachFileList[].filePath String Attached file- path
body.data.attachFileList[].fileName String Attached file - file name
body.data.attachFileList[].fileSize Long Attached file - size
body.data.attachFileList[].fileSequence Integer Attached file - file sequence
body.data.attachFileList[].createDate String Attached file - date of creation
body.data.attachFileList[].updateDate String Attached file - date of modification

Attached Files

Upload Attached Files

Request

[URL]

POST  /sms/v2.4/appKeys/{appKey}/attachfile/binaryUpload
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "fileName": "attachment.jpg",
  "createUser": "CreateUser",
  "fileBody": "{byte[] -> encoded value in Base64}"
}
Value Type Max Length Required Description
fileName String 45 Required File name (extensions available only in jpg or jpeg)
fileBody Byte[] 300K Required File byte[] value encoded in Base64.
* or byte arrangement value
createUser String 100 Required File uploading user information

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/attachfile/binaryUpload' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "fileName": "attachement.jpg",
    "createUser": "API Guide",
    "fileBody": "1234567890"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "fileId": 0,
      "fileName": "attachment.jpg",
      "filePath": "0/toast-mt-2018-08-10/1609/178576"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.fileId Integer File ID
body.data.fileName String File name
body.data.filePath String Default path of attached file
(https://domain/attachFile/filePath/fileName)

Example of Uploading Attached Files

Http method URL
POST https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/attachfile/binaryUpload

[Request body]

{
  "fileName": "attachement.jpg",
  "createUser": "CreateUser",
  "fileBody": "/9j/4AAQSkZJRgABAQEAYABgAAD/4RDSRXhpZgAATU0AKgAAAAgABAE7AAIAAAAESkdHAIdpAAQAAAABAAAISpydAAEAAAAIAAAQwuocAAcAAAgMAAAAPgAAAAAc6gAAAAgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFkAMAAgAAABQAABCYkAQAAgAAABQAABCskpEAAgAAAAM1MgAAkpIAAgAAAAM1MgAA6hwABwAACAwAAAiMAAAAABzqAAAACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMjAxODowMjowOCAxNjoyOTo0MQAyMDE4OjAyOjA4IDE2OjI5OjQxAAAASgBHAEcAAAD/4QsWaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wLwA8P3hwYWNrZXQgYmVnaW49J++7vycgaWQ9J1c1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCc/Pg0KPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyI+PHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj48cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0idXVpZDpmYWY1YmRkNS1iYTNkLTExZGEtYWQzMS1kMzNkNzUxODJmMWIiIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIvPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIj48eG1wOkNyZWF0ZURhdGU+MjAxOC0wMi0wOFQxNjoyOTo0MS41MTc8L3htcDpDcmVhdGVEYXRlPjwvcmRmOkRlc2NyaXB0aW9uPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6ZGM9Imh0dHA6Ly9wdXJsLm9yZy9kYy9lbGVtZW50cy8xLjEvIj48ZGM6Y3JlYXRvcj48cmRmOlNlcSB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6bGk+SkdHPC9yZGY6bGk+PC9yZGY6U2VxPg0KCQkJPC9kYzpjcmVhdG9yPjwvcmRmOkRlc2NyaXB0aW9uPjwvcmRmOlJERj48L3g6eG1wbWV0YT4NCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgPD94cGFja2V0IGVuZD0ndyc/Pv/bAEMABwUFBgUEBwYFBggHBwgKEQsKCQkKFQ8QDBEYFRoZGBUYFxseJyEbHSUdFxgiLiIlKCkrLCsaIC8zLyoyJyorKv/bAEMBBwgICgkKFAsLFCocGBwqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKv/AABEIABoAHQMBIgACEQEDEQH/xAAfAAABBQEBAQEBAQAAAAAAAAAAAQIDBAUGBwgJCgv/xAC1EAACAQMDAgQDBQUEBAAAAX0BAgMABBEFEiExQQYTUWEHInEUMoGRoQgjQrHBFVLR8CQzYnKCCQoWFxgZGiUmJygpKjQ1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4eLj5OXm5+jp6vHy8/T19vf4+fr/xAAfAQADAQEBAQEBAQEBAAAAAAAAAQIDBAUGBwgJCgv/xAC1EQACAQIEBAMEBwUEBAABAncAAQIDEQQFITEGEkFRB2FxEyIygQgUQpGhscEJIzNS8BVictEKFiQ04SXxFxgZGiYnKCkqNTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqCg4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2dri4+Tl5ufo6ery8/T19vf4+fr/2gAMAwEAAhEDEQA/APD6K6e88IxWemTamdQaSx+zW8trJ5GDPJLkGMjd8u0pKCcn7nTmq/jDTbHSvH2qadao1vY2940aqmZGRAe24/MQPU8+tVs7ev4f8OT0uYFFdvrmhWmo/Ee30wXVpp9rcWlvIs0FmIAQbZXX90ZCPMbgY34LHqM1zes6bbaXq81mHv18rAK3tiLeZWxyGj3tt/M5HpTWrsGyv/Wpb1bXIp/DekaLYzXEsFj5kztcRhP3shGVUBmyq44ORksxwM1JrfiyLXtSa/u/DmkpdSXHnzyRPdDz/VWBmIAPfaFPoRXO0UgOk1Pxemq6vb3914d0jMMAgeFftBjmRYxGgbMpYFVUYKlTnqTWfruuz69dQSTW8FrFa26W1vb24bZFGucKC7Mx5JOWYnn0wKy6KAP/2Q=="
}

[Response]

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "fileId": 0,
      "fileName": "attachment.jpg",
      "filePath": "0/toast-mt-2018-08-10/1609/178576"
    }
  }
}

Category

Register

Request

[URL]

POST  /sms/v2.4/appKeys/{appKey}/categories
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "categoryParentId": 0,
  "categoryName": "",
  "categoryDesc": "",
  "useYn": "",
  "createUser": ""
}
Value Type Max Length Required Description
categoryParentId Integer - Optional Parent category ID [Default: Highest category]
categoryName String 50 Required Category ID
categoryDesc String 100 Optional Category name
useYn String 1 Required Use or Not (Y/N)
createUser String 100 Optional Registered user
Description
  • categoryParentId, if empty, is registered right below the highest category.

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/categories' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "categoryParentId": 0,
    "categoryName": "API Guide",
    "categoryDesc": "API 가이드 테스트",
    "useYn": "Y",
    "createUser": "API Guide"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "categoryId": 0,
      "categoryParentId": 0,
      "depth": 0,
      "sort": 0,
      "categoryName": "",
      "categoryDesc": "",
      "useYn": "",
      "createUser": ""
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data[].categoryId Integer Category ID
body.data[].categoryParentId Integer Parent category ID
body.data[].depth Integer Depth of category
body.data[].sort Integer Sorting order of category
body.data[].categoryName String Category name
body.data[].categorycategoryDescame String Category description
body.data[].useYn String Use or not
body.data[].createUser String Registered user

List Category

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/categories
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
pageNum Integer - Optional Page number (default : 1)
pageSize Integer 1000 Optional Query count (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/categories' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 1,
    "data": [
      {
        "categoryId": 137612,
        "categoryParentId": 0,
        "depth": 0,
        "sort": 0,
        "categoryName": "Category",
        "categoryDesc": "Highest category",
        "useYn": "Y",
        "createDate": "2018-04-17 15:39:56.0",
        "createUser": "bb076dc0-ef5e-11e7-9ede-005056ac7022",
        "updateDate": "2018-04-17 15:39:56.0",
        "updateUser": "bb076dc0-ef5e-11e7-9ede-005056ac7022"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure messagae
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data[].categoryId Integer Category ID
body.data[].categoryParentId Integer Parent category ID
body.data[].depth Integer Depth of category
body.data[].sort Integer Sorting order of category
body.data[].categoryName String Category name
body.data[].categorycategoryDescame String Category description
body.data[].useYn String Use or not
body.data[].createDate String Date of registration
body.data[].createUser String Registered user
body.data[].updateDate String Date of modification
body.data[].updateUser String Modified user

Get Category

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/categories/{categoryId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
categoryId Integer Category ID

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/categories/'"${CATEGORY_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": [
      {
        "categoryId": 137612,
        "categoryParentId": 0,
        "depth": 0,
        "sort": 0,
        "categoryName": "Category",
        "categoryDesc": "Highest category",
        "useYn": "Y",
        "createDate": "2018-04-17 15:39:56.0",
        "createUser": "bb076dc0-ef5e-11e7-9ede-005056ac7022",
        "updateDate": "2018-04-17 15:39:56.0",
        "updateUser": "bb076dc0-ef5e-11e7-9ede-005056ac7022"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data[].categoryId Integer Category ID
body.data[].categoryParentId Integer Parent category ID
body.data[].depth Integer Depth of category
body.data[].sort Integer Sorting order of category
body.data[].categoryName String Category name
body.data[].categorycategoryDescame String Category description
body.data[].useYn String Use or not
body.data[].createDate String Date of registration
body.data[].createUser String Registered user
body.data[].updateDate String Date of modification
body.data[].updateUser String Modified user

Modify

Request

[URL]

PUT  /sms/v2.4/appKeys/{appKey}/categories/{categoryId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
categoryId Integer Category ID

[Request body]

{
  "categoryName": "",
  "categoryDesc": "",
  "useYn": "",
  "updateUser": ""
}
Value Type Max Length Required Description
categoryName String 50 Required Category ID
categoryDesc String 100 Optional Category name
useYn String 1 Required Use or not
updateUser String 100 Optional Modified user

cURL

curl -X PUT \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/categories/'"${C_ID}" \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "categoryParentId": 788,
    "categoryName": "secondMMS",
    "categoryDesc": "second category MMS",
    "useYn": "Y",
    "createUser": "467d9790-ea74-11e5-9ad3-005056ac76e8"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": "",
    "resultMessage": ""
  }
}

Delete

Request

[URL]

DELETE  /sms/v2.4/appKeys/{appKey}/categories/{categoryId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
categoryId Integer Category ID

cURL

curl -X DELETE \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/categories/'"${CATEGORY_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": "",
    "resultMessage": ""
  }
}

Templates

Register

Request

[URL]

POST  /sms/v2.4/appKeys/{appKey}/templates
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "categoryId": 0,
  "templateId": "",
  "templateName": "",
  "templateDesc": "",
  "sendNo": "",
  "sendType": "",
  "title": "",
  "body": "",
  "useYn": "",
  "attachFileIdList": [
    0,
    1
  ]
}
Value Type Max Length Required Description
categoryId Integer - Required Category ID
templateId String 50 Required Template ID
templateName String 50 Required Template name
templateDesc String 100 Optional Template description
sendNo String 13 Required Sender number
sendType String 1 Required Delivery type (0:Sms, 1:Lms/Mms)
title String 120 Optional Text title (required, if delivery type is LMS/MMS)
body String 4000 Required Text body
useYn String 1 Required Use or not
attachFileIdList List - Optional Attached file ID(fileId)

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/templates' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "categoryId": 199376,
    "templateId": "TemplateId",
    "templateName": "템플릿 발송 예시",
    "templateDesc": "템플릿 발송 예시",
    "sendNo": "01012341234",
    "sendType": "1",
    "title": "example",
    "body": "일반 발송 테스트용 입니다.\r\n##key1## 님 안녕하세요.\r\n##key2## 입니다.",
    "useYn": "Y"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": "",
    "resultMessage": ""
  }
}

Example of Registration

Http method URL
POST https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/templates

[Request body]

{
  "categoryId": 199376,
  "templateId": "TemplateId",
  "templateName": "Example of template delivery",
  "templateDesc": "Example of template delivery",
  "sendNo": "01012341234",
  "sendType": "1",
  "title": "example",
  "body": "Test for general delivery.Dear \r\n##key1##. This is \r\n##key2##.",
  "useYn": "Y",
  "attachFileIdList": [
    123123,
    456456
  ]
}

[Response]

{
  "header": {
    "isSuccessful": true,
    "resultCode": "",
    "resultMessage": ""
  }
}
Description
  • To deliver long MMS including attached files (field name: attachFileIdList), attached files must be uploaded first.
  • See guides for [Upload Attachment] .
  • Restrictions for Attached Images
    • Supported Codec: .jpg
    • Number of Attached Images: Less than 2
    • Size of Attached Image: Less than 300KB
    • Resolution of Image: Less than 1000 x 1000

Send Templates (requiring no body updates)

Example

Http method Type URL
POST SMS https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/sms
POST MMS https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/mms

For Request URL, choose a delivery type selected to register templates.

If request parameter body is empty, replace it with the body of the corresponding templateId.

[Request body] Replace with key and value for those for replacement.

{
  "templateId": "TemplateId",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "templateParameter": {
        "key1": "Toast Cloud",
        "key2": "SMS"
      },
      "recipientGroupingKey": "RecipientGroupingKey"
    }
  ]
}

[Response]

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "requestId": "20180813095534I4VcVuPBpd0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        }
      ]
    }
  }
}

[Figure 1] Template

Send Templates (requiring body updates)

Example of Sending Tempaltes

Http method Type URL
POST SMS https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/sms
POST MMS https://api-sms.cloud.toast.com/sms/v2.4/appKeys/{appKey}/sender/mms

For Request URL, choose a delivery type selected to register templates.

If template ID and request parameter body include values, sender number and body message are not replaced with template.

Nevertheless, with the input of template ID, it is available to query with the template.

Such case is applicable when template needs to be modified after queried.

[Request body]

{
  "templateId": "TemplateId",
  "body": "body",
  "sendNo": "15446859",
  "senderGroupingKey": "SenderGroupingKey",
  "recipientList": [
    {
      "recipientNo": "01000000000",
      "templateParameter": {
        "key1": "Toast Cloud",
        "key2": "SMS"
      },
      "recipientGroupingKey": "RecipientGroupingKey"
    }
  ]
}

[Response]

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "requestId": "20180813095534I4VcVuPBpd0",
      "statusCode": "2",
      "senderGroupingKey": "SenderGroupingKey",
      "sendResultList": [
        {
          "recipientNo": "01000000000",
          "resultCode": 0,
          "resultMessage": "SUCCESS",
          "recipientSeq": 1,
          "recipientGroupingKey": "RecipientGroupingKey"
        }
      ]
    }
  }
}

List Templates

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/templates
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Required Description
categoryId Integer Optional Category ID
useYn String Optional Use or Not (Y/N)
pageNum Integer Optional Page number (default : 1)
pageSize Integer Optional Query count (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/templates' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "templateId": "ee13efe5-58c2-4e61-a59f-1fa47cc21cd0",
      "serviceId": 71191,
      "categoryId": 415978,
      "categoryName": "categoryName",
      "sort": 0,
      "templateName": "templateName",
      "templateDesc": "templateDescription",
      "useYn": "Y",
      "priority": "S",
      "sendNo": "12341234",
      "sendType": "0",
      "sendTypeName": "SMS 발송",
      "title": "title",
      "body": "body",
      "attachFileYn": "Y",
      "delYn": "N",
      "createDate": "2023-09-18 14:30:03.0",
      "createUser": null,
      "updateDate": "2023-09-18 14:30:03.0",
      "updateUser": null,
      "attachFileList": [
        {
          "fileId": 535186,
          "filePath": "/permanent/71191/toast-mt-2023-09-18/1430/535186",
          "fileName": "attachment.jpg",
          "saveFileName": "20230918eA8JmR0.jpg",
          "uploadType": "TEMPORARY"
        }
      ]
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Faliure message
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data[].templateId String Template ID
body.data[].serviceId Integer Service ID (unused, for internal purpose)
body.data[].categoryId Integer Category ID
body.data[].categoryName String Category name
body.data[].sort Integer Sorted value
body.data[].templateName String Template name
body.data[].templateDesc String Template description
body.data[].useYn String Use or not
body.data[].priority String Priority value (unused)
body.data[].sendNo String Sender number
body.data[].sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data[].sendTypeName String Name of delivery type
body.data[].title String Title
body.data[].body String Body message
body.data[].attachFileYn String Attached or not (Y/N)
body.data[].delYn String Deleted or not (Y/N): only to show current status
body.data[].createDate String Date of registration
body.data[].createUser String Registered user
body.data[].updateDate String Date of modification
body.data[].updateUser String Modifier
body.data[].attachFileList[].fileId Integer Attached file ID
body.data[].attachFileList[].serviceId Integer Service ID (unused, for internal purpose)
body.data[].attachFileList[].attachType Integer Upload type of attachment (0:Temporary,1:Upload,2:Template)
body.data[].attachFileList[].templateId String Template ID
body.data[].attachFileList[].filePath String Path of attached file
body.data[].attachFileList[].fileName String Name of attached file
body.data[].attachFileList[].fileSize Integer File size
body.data[].attachFileList[].createDate String Date of registration for attachment
body.data[].attachFileList[].createUser String Registered user of attachment

Query Single Template

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/templates/{templateId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
templateId String Template ID

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/templates/'"${TEMPLATE_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 1,
    "data": [
      {
        "templateId": "ee13efe5-58c2-4e61-a59f-1fa47cc21cd0",
        "serviceId": 71191,
        "categoryId": 415978,
        "categoryName": "categoryName",
        "sort": 0,
        "templateName": "templateName",
        "templateDesc": "templateDescription",
        "useYn": "Y",
        "priority": "S",
        "sendNo": "15771234",
        "sendType": "0",
        "sendTypeName": "SMS 발송",
        "title": "title",
        "body": "body",
        "attachFileYn": "Y",
        "delYn": "N",
        "createDate": "2023-09-18 14:30:03.0",
        "createUser": null,
        "updateDate": "2023-09-18 14:30:03.0",
        "updateUser": null,
        "attachFileList": [
          {
            "fileId": 535186,
            "filePath": "/permanent/71191/toast-mt-2023-09-18/1430/535186",
            "fileName": "attachment.jpg",
            "saveFileName": "20230918eA8JmR0.jpg",
            "uploadType": "TEMPORARY"
          }
        ]
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data.templateId String Template ID
body.data.serviceId Integer Service ID (unused, for internal purpose)
body.data.categoryId Integer Category ID
body.data.categoryName String Category name
body.data.sort Integer Sorted value
body.data.templateName String Template name
body.data.templateDesc String Template description
body.data.useYn String Use or not
body.data.priority String Priority value (unused)
body.data.sendNo String Sender number
body.data.sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data.sendTypeName String Name of delivery type
body.data.title String Title
body.data.body String Body message
body.data.attachFileYn String Attached or not (Y/N)
body.data.delYn String Deleted or not (Y/N): only to show current status
body.data.createDate String Date of registration
body.data.createUser String Registered user
body.data.updateDate String Date of modification
body.data.updateUser String Modifier
body.data.attachFileList[].fileId Integer Attached file ID
body.data.attachFileList[].serviceId Integer Service ID (unused, for internal purpose)
body.data.attachFileList[].attachType Integer Upload type of attachment (0:Temporary,1:Upload,2:Template)
body.data.attachFileList[].templateId String Template ID
body.data.attachFileList[].filePath String Path of attachment
body.data.attachFileList[].fileName String Name of attachment
body.data.attachFileList[].fileSize Integer File size
body.data.attachFileList[].createDate String Date of registration of attachment
body.data.attachFileList[].createUser String Registered user of attachment

Modify

Request

[URL]

PUT  /sms/v2.4/appKeys/{appKey}/templates/{templateId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "templateName": "",
  "templateDesc": "",
  "sendNo": "",
  "sendType": "",
  "title": "",
  "body": "",
  "useYn": "",
  "attachFileIdList": [
    0,
    1
  ]
}
Value Type Max Length Required Description
templateName String 50 Required Template name
templateDesc String 100 Optional Template description
sendNo String 13 Required Sender number
sendType String 1 Required Delivery type (0:Sms, 1:Lms/Mms)
title String 120 Optional Text title (required, if delivery type is Lms/MmS)
body String 4000 Required Text body
useYn String 1 Required Use or not
attachFileIdList List - Optional Attached file ID(fileId)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/templates/'"${TEMPLATE_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": "",
    "resultMessage": ""
  }
}

Delete

Request

[URL]

DELETE  /sms/v2.4/appKeys/{appKey}/templates/{templateId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
templateId String Template ID

cURL

curl -X DELETE \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/templates/'"${TEMPLATE_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": "",
    "resultMessage": ""
  }
}

Rejection of Receiving 080 Numbers

Register Unsubsribers

Request

[URL]

POST /sms/v2.4/appKeys/{appKey}/blockservice/recipients
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "unsubscribeNo": "0800000000",
  "recipientNoList": [
    "0100000000",
    "0100000001"
  ]
}
Value Type Max Length Required Description
unsubscribeNo String 25 O 080 numbers to reject receiving
recipientNoList List 10 O Contact number of unsubscribers to be added

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/blockservice/recipients' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "unsubscribeNo": "0800000000",
    "recipientNoList": ["0100000000", "0100000001"]
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "Success"
  }
}

Query Target of Rejection

Request

[URL]

GET  /sms/v2.4/appKeys/{appKey}/blockservice/recipients
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
unsubscribeNo String 25 Required 080 numbers to reject receiving
recipientNo String 25 Optional Contact number of unsubscribers
startRequestDate String - Optional Start value of request for reject receiving (yyyy-MM-dd HH:mm:ss)
endRequestDate String - Optional End value of request for reject receiving (yyyy-MM-dd HH:mm:ss)
pageNum Integer - Optional Page number (default: 1)
pageSize Integer 1000 Optional Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/blockservice/recipients' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 1,
    "data": [
      {
        "unsubscribeNo": "0808888888",
        "recipientNo": "01000000000",
        "requestDate": "2018-05-14 17:07:29.0"
      }
    ]
  }
}

Delete Target of Rejection

Request

[URL]

DELETE  /sms/v2.4/appKeys/{appKey}/blockservice/recipients/removes?unsubscribeNo={unsubscribeNo}&updateUser={updateUser}&recipientNoList={recipientNo},{recipientNo}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
unsubscribeNo String 20 Required 080 numbers to reject receiving
updateUser String 100 Required User who delete rejection of receiving
recipientNo String 20 Required Rejected numbers to be deleted

cURL

curl -X DELETE \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/blockservice/recipients/removes?unsubscribeNo='"${UNSUB_NO}"'&updateUser='"${UPDATE_USER}"'&recipientNoList='"${RECIPIENT_NO}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "SUCCESS",
    "isSuccessful": true
  },
  "body": null
}

Sender Numbers

List Registered Sender Numbers API

Request

[URL]

Http method URI
GET /sms/v2.4/appKeys/{appKey}/sendNos?sendNo={sendNo}&useYn={useYn}&blockYn={blockYn}&pageNum={pageNum}&pageSize={pageSize}

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Description
sendNo String Sender number
useYn String Use or not
blockYn String Block or not
pageNum Integer Page number (default: 1)
pageSize Integer Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sendNos' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 2,
    "data": [
      {
        "appKey": null,
        "serviceId": 71191,
        "sendNo": "01012341234",
        "useYn": "Y",
        "blockYn": "N",
        "blockReason": null,
        "createDate": "2023-07-18 12:05:35",
        "createUser": "test@nhn.com",
        "updateDate": "2023-07-31 13:45:48",
        "updateUser": "test@nhn.com"
      },
      {
        "appKey": null,
        "serviceId": 71191,
        "sendNo": "12341234",
        "useYn": "Y",
        "blockYn": "N",
        "blockReason": null,
        "createDate": "2023-09-14 10:30:30",
        "createUser": "test@nhn.com",
        "updateDate": "2023-09-14 10:30:30",
        "updateUser": null
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.pageNum Integer Page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data[].serviceId Integer Service ID
body.data[].sendNo String Sender number
body.data[].useYn String Use or not
body.data[].blockYn String Block or not
body.data[].blockReason String Cause of blockage
body.data[].createDate String Date and time of creation
body.data[].createUser String Creator
body.data[].updateDate String Date of modification
body.data[].updateUser String Modified user

Query Statistics

Search Statistics - Based on Events

  • Statistics are collected based on time of event occurrence.
  • Statistics are collected based on the following time criteria:
    • Request Count (requested): Delivery request time
    • Delivery Count (sent): Delivery request time to telco provider (vendor)
    • Success Count(received): Actual received time on device
    • Failure Count (sentFailed): Response time of failure

Request

[URL]

Http method URI
GET /sms/v2.4/appKeys/{appKey}/stats

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Maximum Length Required Description
statisticsType String - Required Type of statistics
NORMAL:Default, MINUTELY:By the minute, HOURLY: By the hour, DAILY: By the day, BY_DAY:By day
from String - Required Start Date of Statistics Search
yyyy-MM-dd HH:mm:ss
to String - Required End Date of Statistics Search
yyyy-MM-dd HH:mm:ss
statsIds List - Optional Statistics ID List
messageType String - Optional Message Type
SMS, LMS, MMS, AUTH
isAd Boolean - Optional Ad or Not
true/false
templateIds List - Optional Template ID List
requestIds List 5 Optional Request ID List
statsCriteria List Option Stats criteria
- EVENT: event(default value)
- TEMPLATE_ID,EVENT: template, event
- EXTRA_1,EVENT: message type, event
- EXTRA_2,EVENT: ad on/off, event
- EXTRA_3,EVENT: calling number, event

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/stats?statisticsType='"${STATISTICS_TYPE}"'&from='"${FROM}"'&to='"${TO}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": [
      {
        "eventDateTime": "",
        "events": {
          "{statsCriteriaValue}.requested": 10,
          "{statsCriteriaValue}.sent": 10,
          "{statsCriteriaValue}.sentFailed": 0,
          "{statsCriteriaValue}.received": 0
        }
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.eventDateTime String Display name
Minutely, Hourly, Daily, Monthly
body.data.events[].{statsCriteriaValue} List Value for statsCriteria
This can be message type/ad type/calling number value
If statsCriteria is set to EVENT only, {statsCriteriaValue} is omitted
body.data.events[].{statsCriteriaValue}.requested Integer Number of requests
body.data.events[].{statsCriteriaValue}.sent Integer Number of sent items
body.data.events[].{statsCriteriaValue}.sentFailed Integer Number of failures
body.data.events[].{statsCriteriaValue}.received Integer Number of successes

Statistics Search - Based on Request Time

  • Statistics are collected based on delivery request time.
  • Statistics are collected based on the following criteria:
    • Request Count (requested): Delivery request time
    • Delivery Count (sent): Delivery request time, with the increase incurred when delivery is requested to telecom provider (vendor)
    • Success count (received): Delivery request time, with the increase incurred on the actual received time on device
    • Failure Count (sentFailed): Delivery request time, with the increase incurred on the response time of failure

Request

[URL]

Http method URI
GET /sms/v2.4/appKeys/{appKey}/stats/legacy

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
statisticsType String - Required Statistics Category
NORMAL:Default, MINUTELY:By the minute, HOURLY:By the hour, DAILY: By the day, BY_DAY:By day
from String - Required Start date of statistics search
yyyy-MM-dd HH:mm:ss
to String - Required End date of statistics search
yyyy-MM-dd HH:mm:ss
statsIds List - Optional Statistics ID List
messageType String - Optional Message Type
SMS, LMS, MMS, AUTH
isAd Boolean - Optional Ad or not
true/false
templateIds List - Optional Template ID List
requestIds List 5 Optional Request ID List
statsCriteria List Option Stats criteria
- EVENT: event(default value)
- TEMPLATE_ID,EVENT: template, event
- EXTRA_1,EVENT: message type, event
- EXTRA_2,EVENT: ad on/off, event
- EXTRA_3,EVENT: calling number, event

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": [
      {
        "eventDateTime": "",
        "events": {
          "{statsCriteriaValue}.requested": 10,
          "{statsCriteriaValue}.sent": 10,
          "{statsCriteriaValue}.sentFailed": 0,
          "{statsCriteriaValue}.received": 0,
          "{statsCriteriaValue}.pending": 0
        }
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.eventDateTime String Display name
Minutely,Hourly, Daily, and Monthly
body.data.events[].{statsCriteriaValue} List Value for statsCriteria
This can be message type/ad type/calling number value
If statsCriteria is set to EVENT only, {statsCriteriaValue} is omitted
body.data.events[].{statsCriteriaValue}.requested Integer Number of requests
body.data.events[].{statsCriteriaValue}.sent Integer Number of sent items
body.data.events[].{statsCriteriaValue}.sentFailed Integer Number of failures
body.data.events[].{statsCriteriaValue}.received Integer Number of successes
body.data.events[].{statsCriteriaValue}.pending Integer Number of pending items

(Old)Query Integrated Statistics

Request

[URL]

Http method URI
GET /sms/v2.4/appKeys/{appKey/statistics/view?searchType={searchType}&from={from}&to={to}&messageTypes={messageType}&contentTypes={contentType}&templateId={templateId}

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
searchType String 10 O Type of statistics
DATE:By date, TIME:By time, DAY:By day
from String - O Start date of query statistics
yyyy-MM-dd HH:mm
to String - O End date of query statistics
yyyy-MM-dd HH:mm
messageType String 10 X Message type
SMS: Short messages, LMS: Long messages, MMS: Attachment, AUTH: Authentication
contentType String 10 X Content type
NORMAL: General, AD: Advertisement
templateId String 50 X Template ID

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": [
      {
        "divisionName": "2018-06-01",
        "statisticsView": {
          "requestedCount": 10,
          "succeedCount": 10,
          "failedCount": 0,
          "pendingCount": 0,
          "succeedRate": "100.00",
          "failedRate": "0.00",
          "pendingRate": "0.00"
        }
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data[].divisionName String Display name
Date, time, Day
body.data[].statisticsView Object
body.data[].requestedCount Integer Number of requests
body.data[].succeedCount Integer Success count
body.data[].failedCount Integer Failure count
body.data[].pendingCount Integer Delivery count
body.data[].succeedRate String Success rate
body.data[].failedRate String Failure rate
body.data[].pendingRate String Delivery rate

Scheduled Delivery

List Scheduled Delivery

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/reservations
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
sendType String 1 Optional Delivery type
(0:SMS, 1:LMS/MMS, 2:AUTH)
requestId String 25 Optional Request ID
startRequestDate String - Optional Start date of sending (yyyy-MM-dd HH:mm:ss)
endRequestDate String - Optional End date of sending (yyyy-MM-dd HH:mm:ss)
startCreateDate String - Optional Start date of registration (yyyy-MM-dd HH:mm:ss)
endCreateDate String - Optional End date of registration (yyyy-MM-dd HH:mm:ss)
sendNo String 13 Optional Sender number
recipientNo String 20 Optional Recipient number
templateId String 50 Optional Template number
messageStatus String 10 Optional Message status
(RESERVED: Ready for schedule, SENDING: Sending, COMPLETED:Delivery completed, FAILED: Delivery failed, CANCEL: Canceled, DUPLICATED: Duplicate delivery, FAILED_AD: Failed (Ad restricted), RESEND_AD: Waiting for Resending (Ad restricted))
pageNum Integer - Optional Page number (default: 1)
pageSize Integer 1000 Optional Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/reservations' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "pageNum": 1,
    "pageSize": 15,
    "totalCount": 15,
    "data": [
      {
        "requestId": "{request ID}",
        "recipientSeq": 1,
        "requestDate": "{scheduled date}",
        "sendNo": "{sender number}",
        "recipientNo": "{recipient number}",
        "countryCode": "{country code}",
        "sendType": "{delivery type}",
        "messageType": "{message type}",
        "adYn": "{Ad or not}",
        "templateId": "{template ID}",
        "templateParameter": "{template parameter}",
        "templateName": "{template name}",
        "title": "{title}",
        "body": "{body}",
        "messageStatus": "{message status}",
        "createUser": "{registered user}",
        "createDate": "{date and time of registration}",
        "updateDate": "{modified date}"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data[].requestId String Request ID
body.data[].recipientSeq Integer Recipient sequence
body.data[].requestDate String Date and time of sending
body.data[].sendNo String Sender number
body.data[].recipientNo String Recipient number
body.data[].countryCode String Country code
body.data[].sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data[].messageType String Message type
(SMS,LMS,MMS,AUTH)
body.data[].adYn String Ad or not
body.data[].templateId String Template ID
body.data[].templateParameter String(json) Template parameter
body.data[].templateName String Template name
body.data[].title String Title
body.data[].body String Body message
body.data[].messageStatus String Message status
(RESERVED: Ready for schedule, SENDING: Sending, COMPLETED:Delivery completed, FAILED: Delivery failed, CANCEL: Canceled, DUPLICATED: Duplicate delivery, FAILED_AD: Failed (Ad restricted), RESEND_AD: Waiting for Resending (Ad restricted))
body.data[].createUser String Registered user
body.data[].createDate String Date of registration
body.data[].updateDate String Date of modification

Query Detail Scheduled Delivery

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/reservations/{requestId}/{recipientSeq}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
requestId String Request ID
recipientSeq Integer Recipient sequence

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/reservations/'"${R_ID}"'/'"${R_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "requestId": "{request ID}",
      "recipientSeq": 1,
      "requestDate": "{scheduled date}",
      "sendNo": "{sender number}",
      "recipientNo": "{recipient number}",
      "countryCode": "{country code}",
      "sendType": "{delivery type}",
      "messageType": "{message type}",
      "adYn": "{ad or not}",
      "templateId": "{template ID}",
      "templateParameter": "{template parameter}",
      "templateName": "{template name}",
      "title": "{title}",
      "body": "{body}",
      "messageStatus": "{message status}",
      "createUser": "{registered user}",
      "createDate": "{date and time of registration}",
      "updateDate": "{modified date}",
      "attachFileList": [
        {
          "fileId": 0,
          "filePath": "26606/toast-mt-2018-02-07/1555/105887/",
          "fileName": "file_attach_test.jpg"
        }
      ]
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.pageNum Integer Current page number
body.pageSize Integer Queried data count
body.totalCount Integer Total data count
body.data.requestId String Request ID
body.data.recipientSeq Integer Recipient sequence
body.data.requestDate String Date and time of sending
body.data.sendNo String Sender number
body.data.recipientNo String Recipient number
body.data.countryCode String Country code
body.data.sendType String Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
body.data.messageType String Message type
(SMS,LMS,MMS,AUTH)
body.data.adYn String Ad or not
body.data.templateId String Template ID
body.data.templateParameter String(json) Template parameter
body.data.templateName String Template name
body.data.title String Title
body.data.body String Body message
body.data.messageStatus String Message status
(RESERVED: Ready for schedule, SENDING: Sending, COMPLETED:Delivery completed, FAILED: Delivery failed, CANCEL: Canceled, DUPLICATED: Duplicate delivery, FAILED_AD: Failed (Ad restricted), RESEND_AD: Waiting for Resending (Ad restricted))
body.data.createUser String Registered user
body.data.createDate String Date of registration
body.data.attachFileList[].fileId Integer File ID
body.data.attachFileList[].filePath String File path (for internal purpose)
body.data.attachFileList[].fileName String File name

Cancel Scheduled Delivery

Request

[URL]

PUT /sms/v2.4/appKeys/{appKey}/reservations/cancel
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "reservationList": [
    {
      "requestId": "{requestId}",
      "recipientSeq": 1
    }
  ],
  "updateUser": "{updateUser}"
}
Value Type Max Length Required Description
reservationList[].requestId String 25 O Request ID
reservationList[].recipientSeq Integer - O Recipient sequence
updateUser String 100 O Requesting user for cancellation

cURL

curl -X PUT \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/reservations/cancel' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "reservationList": [{
            "requestId": "1",
            "recipientSeq": 1
        }
    ],
    "updateUser": "API Guide"
}'

[Response body]

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "requestedCount": 1,
      "canceledCount": 1
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.requestedCount Integer Number of failed requests
body.data.canceledCount Integer Number of successful cancellation

Cancel Scheduled Delivery - Multiple Filter

Request

  • Request for schedule cancellation is available only when the statu is 'Scheduled'.
  • Cannot cancel already delivered messages.

[URL]

PUT /sms/v2.4/appKeys/{appKey}/reservations/search-cancels
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

{
  "searchParameter": {
    "sendType": "0",
    "startRequestDate": "2020-02-01 00:00",
    "endRequestDate": "2020-02-01 10:00",
    "startCreateDate": "2020-02-01 00:00",
    "endCreateDate": "2020-02-01 10:00",
    "sendNo": "15880000",
    "recipientNo": "0100000000",
    "templateId": "TemplateId",
    "requestId": "20200201010630ReZQ6KZzAH0",
    "createUser": "CreateUser",
    "senderGroupingKey": "SenderGroupingKey"
  },
  "updateUser": "UpdateUser"
}
  • startRequestDate + endRequestDate or startCreateDate + endCreateDate is required.
  • To query registered date and reserved date at the same time, reserved date shall be ignored.
Value Type Max Length Required Description
searchParameter.sendType String 1 Required Delivery type(0:Sms, 1:Lms/Mms, 2:Auth)
searchParameter.startRequestDate String - Required Start date of delivery
searchParameter.endRequestDate String - Required End date of delivery
searchParameter.startCreateDate String - Required Start date of registration
searchParameter.endCreateDate String - Required End date of registration
searchParameter.sendNo String 20 Optional Sender number
searchParameter.recipientNo String 20 Optional Recipient number
searchParameter.templateId String 50 Optional Delivery template ID
searchParameter.requestId String 25 Optional Request ID
searchParameter.createUser String 100 Optional Request Creator of Scheduled Delivery
searchParameter.senderGroupingKey String 100 Optional Sender group key
searchParameter.recipientGroupingKey String 100 Optional Recipient group key
updateUser String 100 Required Requester of Scheduled Cancellation

cURL

curl -X PUT \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/reservations/search-cancels' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "searchParameter": {
        "sendType": "0",
        "startRequestDate": "2020-02-01 00:00",
        "endRequestDate": "2020-02-01 10:00",
        "startCreateDate": "2020-02-01 00:00",
        "endCreateDate": "2020-02-01 10:00",
        "sendNo": "15880000",
        "recipientNo": "0100000000",
        "templateId": "TemplateId",
        "requestId": "20200201010630ReZQ6KZzAH0",
        "createUser": "CreateUser",
        "senderGroupingKey": "SenderGroupingKey"
    },
    "updateUser": "API Guide"
}'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "data": {
      "reservationCancelId": "20200210113330OepQ1sAzSDa",
      "requestedDateTime": "2020-02-10 11:33:30",
      "reservationCancelStatus": "READY"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.reservationCancelId Integer Schedule Cancellation ID
body.data.requestedDateTime String Time for Schedule Cancellation(yyyy-MM-dd HH:mm:ss)
body.data.reservationCancelStatus String Status of Schedule Cancellation
- READY : Preparing for Scheduling
- PROCESSING : Cancelling Schedule
- COMPLETED : Schedule Cancellation Completed
- FAILED : Schedule Cancellation Failed

List Request of Scheduled Delivery Cancellation - Multiple Filter

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/reservations/search-cancels?startRequestedDateTime={startRequestedDateTime}&endRequestedDateTime={endRequestedDateTime}&reservationCancelId={reservationCancelId}&pageNum={pageNum}&pageSize={pageSize}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
startRequestedDateTime String - Optional Request Start Time for Schedule Cancellation(yyyy-MM-dd HH:mm:ss)
endRequestedDateTime String - Optional Request End Time for Schedule Cancellation(yyyy-MM-dd HH:mm:ss)
reservationCancelId String 25 Optional Schedule Cancellation ID
pageNum Integer - Optional Page number (default: 1)
pageSize Integer 1000 Optional Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/reservations/search-cancels' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "resultCode": 0,
    "resultMessage": "success",
    "isSuccessful": true
  },
  "body": {
    "data": [
      {
        "reservationCancelId": "",
        "searchParameter": {
        },
        "requestedDateTime": "",
        "completedDateTime": "",
        "reservationCancelStatus": "",
        "totalCount": 0,
        "successCount": 0,
        "createUser": "",
        "createdDateTime": "",
        "updatedDateTime": ""
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data[].reservationCancelId String Schedule Cancellation ID
body.data[].searchParameter Map Request Parameter for Schedule Cancellation
body.data[].requestedDateTime String Request Time for Schedule Cancellation
body.data[].completedDateTime String Request End Time for Schedule Cancellation
body.data[].reservationCancelStatus String Status of Schedule Cancellation
- READY : Preparing for Scheduling
- PROCESSING : Cancelling Schedule
- COMPLETED : Schedule Cancellation Completed
- FAILED : Schedule Cancellation Failed
body.data[].totalCount Integer Number of Scheduled Cancellation Targets
body.data[].successCount Integer Number of Successful Schedule Cancellation
body.data[].createUser String Requester of Scheduled Cancellation
body.data[].createdDateTime String Request Creation Time for Schedule Cancellation
body.data[].updatedDateTime String Modified Time for Scheduled Cancellation

Download Delivery Result Files

Request for Creating Query Files

Request

[URL]

POST /sms/v2.4/appKeys/{appKey}/sender/download-reservations
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Request body]

  • requestId or startRequestDate + endRequestDate or startCreateDate + endCreateDate is required.
  • To query registered date and sent date at the same time, sent date shall be ignored.
{
  "sendType": "1",
  "requestId": "20190601100630ReZQ6KZzAH0",
  "startRequestDate": "2019-06-01 00:00:00",
  "endRequestDate": "2019-06-08 00:00:00",
  "startCreateDate": "2019-06-01 00:00:00",
  "endCreateDate": "2019-06-08 00:00:00",
  "startResultDate": "2019-06-01 00:00:00",
  "endResultDate": "2019-06-08 00:00:00",
  "sendNo": "15446859",
  "recipientNo": "01000000000",
  "templateId": "TemplateId",
  "msgStatus": "3",
  "resultCode": "MTR2",
  "subResultCode": "MTR2_3",
  "senderGroupingKey": "{sender's group key}",
  "recipientGroupingKey": "{recipient's group key}",
  "isIncludeTitleAndBody": true
}
Value Type Max Length Required Description
sendType String 1 O Delivery type (0:Sms, 1:Lms/Mms, 2:Auth)
requestId String 25 Conditionally required (no.1) Request ID
startRequestDate String - Conditionally required (no.2) Start date of delivery (yyyy-MM-dd HH:mm:ss)
endRequestDate String - Conditionally required (no.2) End date of delivery (yyyy-MM-dd HH:mm:ss)
startCreateDate String - Required Start date of registration (yyyy-MM-dd HH:mm:ss)
endCreateDate String - Required End date of registration (yyyy-MM-dd HH:mm:ss)
startResultDate String - Optional Start date of receiving (yyyy-MM-dd HH:mm:ss)
endResultDate String - Optional End date of receiving (yyyy-MM-dd HH:mm:ss)
sendNo String 13 Optional Sender number
recipientNo String 20 Optional Receiving number
templateId String 50 Optional Template number
msgStatus String 1 Optional Message status code (0:Failed, 1: requesting, 2: processing, 3:successful, 4:Delivery Cancelled, 5:Duplicate Delivery, 6: Failed (Ad restricted), 7: Waiting for Resending (Ad restricted))
resultCode String 10 Optional Result code of receiving [Table on Query Codes]
subResultCode String 10 Optional Detail code of receiving [Table on Query Codes]
senderGroupingKey String 100 Optional Sender's group key
recipientGroupingKey String 100 Optional Recipient's group key
isIncludeTitleAndBody Boolean - Optional Title and body included or not

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/sender/download-reservations' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "sendType": "1",
    "startRequestDate": "2020-08-01T00:00:00",
    "endRequestDate": "2020-08-08T00:00:00"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "success"
  },
  "body": {
    "data": {
      "downloadId": "20190610100630ReZQ6KZzAH0",
      "downloadType": "NORMAL",
      "fileType": "CSV",
      "downloadStatusCode": "COMPLETED",
      "expiredDate": "2019-07-09 10:06:00.0"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.downloadId String Download ID
body.data.downloadType String Download type
- BLOCK: Block receiving
- NORMAL: General delivery
- MASS: Mass delivery
- TAG: Tag delivery
body.data.fileType String File type (currently supports csv only)
body.data.downloadStatusCode String Status of File Creation
- READY: Preparing to create
- MAKING: Creating
- COMPLETED: Creation completed
- FAILED: Creation failed
- EXPIRED: Download period expired
body.data.expiredDate String Date and time of expiration for download period

Query Request History for Delivery Result of File Creation

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/download-reservations?downloadId={downloadId}&downloadStatusCode={downloadStatusCode}&pageNum={pageNum}&pageSize={pageSize}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey

[Query parameter]

Value Type Max Length Required Description
downloadId String 25 Optional Download ID
downloadStatusCode String 10 Optional Status code of download file
pageNum Integer - Optional Page number (default: 1)
pageSize Integer 1000 Optional Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/download-reservations' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "totalCount": 0,
    "data": [
      {
        "downloadId": "",
        "downloadType": "",
        "fileType": "",
        "parameter": "",
        "size": 0,
        "downloadStatusCode": "",
        "resultMessage": "",
        "expiredDate": "",
        "createUser": "",
        "createDate": "",
        "updateDate": ""
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.totalCount Integer Total count
body.data[].downloadId String Download ID
body.data[].downloadType String Download type
- BLOCK: Block receiving
- NORMAL: General delivery
- MASS: Mass delivery
- TAG: Tag delivery
body.data[].fileType String File type
body.data[].parameter String Request parameter
body.data[].size Integer Size of query data
body.data[].downloadStatusCode String Status of file creation
- READY: Preparing to create
- MAKING: Creating
- COMPLETED: Creation completed
- FAILED: Creation failed
- EXPIRED: Download period expired
body.data[].resultMessage String Result message (respond when it fails)
body.data[].expiredDate String Date and time of file expiration
body.data[].createUser String Requester for file creation
body.data[].createDate String Date and time of request for file creation
body.data[].updateDate String Date and time of completion or failure of file creation

Request for Downloading Delivery Result Files

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/download-reservations/{downloadId}/download
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appkey
downloadId String Download ID

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/download-reservations/'"${DOWNLOAD_RESERVATION_ID}"'/download' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

file byte

Tag Management

Query Tags

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/tags?pageNum={pageNum}&pageSize={pageSize}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey

[Query parameter]

Value Type Max Length Required Description
pageNum Integer - Optional Page number (Default : 1)
pageSize Integer 1000 Optional Number of queries (Default : 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tags' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "pageNum": 1,
    "pageSize": 1,
    "totalCount": 1,
    "data": [
      {
        "tagId": "ABCD1234",
        "tagName": "TAG",
        "createdDate": "2019-01-01 00:00:00",
        "updatedDate": "2019-01-01 00:00:00"
      }
    ]
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.pageNum Integer Page number
body.pageSize Integer Number of queries
body.totalCount Integer Total data count
body.data[].tagId String Tag ID
body.data[].tagName String Tag name
body.data[].createdDate String Date and time of creation
body.data[].tagId String Date and time of modification

Register Tags

[URL]

POST /sms/v2.4/appKeys/{appKey}/tags
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey

[Request body]

{
  "tagName": "TAG"
}
Value Type Max Length Required Description
tagName String 30 Required Tag name

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tags' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "tagName": "API-Guide"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "tagId": "ABCD1234"
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.tagId String Tag ID

Modify Tags

[URL]

PUT /sms/v2.4/appKeys/{appKey}/tags/{tagId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey
tagId String Tag ID

[Request body]

{
  "tagName": "TAG"
}
Value Type Max Length Required Description
tagName String 30 Required Tag name

cURL

curl -X PUT \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tags/'"${TAG_ID}" \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "tagName": "API-Guide2"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": null
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message

Delete Tags

[URL]

DELETE /sms/v2.4/appKeys/{appKey}/tags/{tagId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey
tagId String Tag ID

cURL

curl -X DELETE \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/tags/'"${TAG_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": null
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message

UID Management

Query UIDs

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/uids?wheres={wheres}&offsetUid={offsetUid}&offset={offset}&limit={limit}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey

[Query parameter]

Value Type Max Length Required Description
wheres List - Optional Query conditions.
Character strings comprised of alphabets, numbers, and parentheses.
Allows one parenthesis, and up to three AND or ORs.
e.g.) tagId1,AND,tagId2
offsetUid String - Optional offset UID
offset Integer - Optional offset (default: 0)
limit Integer 1000 Optional Number of queries (default: 15)

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/uids' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "uids": [
        {
          "uid": "UID",
          "tags": [
            {
              "tagId": "ABCD1234",
              "tagName": "TAG",
              "createdDate": "2019-01-01 00:00:00",
              "updatedDate": "2019-01-01 00:00:00"
            }
          ],
          "contacts": [
            {
              "contactType": "PHONE_NUMBER",
              "contact": "test@nhn.com",
              "createdDate": "2019-01-01 00:00:00"
            }
          ]
        }
      ],
      "last": false,
      "totalCount": 5
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.uids[].uid String UID
body.data.uids[].tags[].tagId String Tag ID
body.data.uids[].tags[].tagName String Tag name
body.data.uids[].tags[].createdDate String Date and time of tag creation
body.data.uids[].tags[].updatedDate String Date and time of tag modification
body.data.uids[].contacts[].contactType String Contact type(PHONE_NUMBER)
body.data.uids[].contacts[].contact String Contact (phone number)
body.data.uids[].contacts[].createdDate String Date and time of contact creation
body.data.uids[].last Boolean Last on list or not

Get UIDs

Request

[URL]

GET /sms/v2.4/appKeys/{appKey}/uids/{uid}

[Path parameter]

Value Type Description
appKey String Original appKey
uid String UID

cURL

curl -X GET \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/uids/'"${USER_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "uid": "UID",
      "tags": [
        {
          "tagId": "ABCD1234",
          "tagName": "TAG",
          "createdDate": "2019-01-01 00:00:00",
          "updatedDate": "2019-01-01 00:00:00"
        }
      ],
      "contacts": [
        {
          "contactType": "PHONE_NUMBER",
          "contact": "0100000000",
          "createdDate": "2019-01-01 00:00:00"
        }
      ]
    }
  }
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
body.data.uid String UID
body.data.tags[].tagId String Tag ID
body.data.tags[].tagName String Tag name
body.data.tags[].createdDate String Date and time of tag creation
body.data.tags[].updatedDate String Date and time of tag modification
body.data.contacts[].contactType String Contact type
body.data.contacts[].contact String Contact(phone number)
body.data.contacts[].createdDate String Date and time of contact creation

Register UIDs

[URL]

POST /sms/v2.4/appKeys/{appKey}/uids
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey

[Request body]

{
  "uids": [
    {
      "uid": "UID",
      "tagIds": [
        "ABCD1234"
      ],
      "contacts": [
        {
          "contactType": "PHONE_NUMBER",
          "contact": "0100000000"
        }
      ]
    }
  ]
}
Value Type Max Length Required Description
uid String - Required UID
tagIds[] String - Required List of tag IDs
contacts[].contactType String - Required Contact type(PHONE_NUMBER)
contacts[].contact String - Required Contact (phone number)

[Caution]

  • When tagIds is provided, contacts is not required.
  • When contacts is provided, tagIds is not required.
  • For this product, contactType must be requested in the "PHONE_NUMBER" value.

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/uids/' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "uids": [{
            "uid": "USER ID",
            "contacts": [{
                    "contactType": "PHONE_NUMBER",
                    "contact": "0100000000"
                }
            ]
        }
    ]
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": null
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message

Delete UIDs

[URL]

DELETE /sms/v2.4/appKeys/{appKey}/uids/{uid}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey
uid String UID

cURL

curl -X DELETE \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/uids/'"${USER_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": null
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message

Register Phone Number

[URL]

POST /sms/v2.4/appKeys/{appKey}/uids/{uid}/phone-numbers
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey
uid String UID

[Request body]

{
  "phoneNumber": "0100000000"
}
Value Type Max Length Required Description
phoneNumber String - Required Phone number

cURL

curl -X POST \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/uids/'"${USER_ID}/phone-numbers" \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "phoneNumber": "0100000000"
}'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": null
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message

Delete phone number

[URL]

DELETE /sms/v2.4/appKeys/{appKey}/uids/{uid}/phone-numbers/{phoneNumber}
Content-Type: application/json;charset=UTF-8

[Path parameter]

Value Type Description
appKey String Original appKey
uid String UID
phoneNumber String Phone number

cURL

curl -X DELETE \
'https://api-sms.cloud.toast.com/sms/v2.4/appKeys/'"${APP_KEY}"'/uids/'"${USER_ID}"'/phone-numbers/'"${P_NO}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
  "header": {
    "isSuccessful": true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": null
}
Value Type Description
header.isSuccessful Boolean Successful or not
header.resultCode Integer Failure code
header.resultMessage String Failure message
Table of Contents
TOP