API v1.6 Guide - NHN Cloud User Guide

Notification > Email > API v1.6 Guide

[API Domain]

Environment	Domain
Real	https://email.api.nhncloudservice.com

[Header]

Content-Type: application/json;charset=UTF-8

[Caution for Curl Example]

Curl Example may not be properly requested in Windows cmd.

Mail Delivery

Send General Mails

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/sender/mail

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Request Body]

Value	Type	Required	Description
senderAddress	String	O	Sender's mail address
senderName	String	X	Sender's name
requestDate	String	X	Enter current time when delivery time is missing (yyyy-MM-dd HH:mm:ss)
title	String	O	Title
body	String	O	Body
attachFileIdList	List:String	X	ID of uploaded attachment
templateId	String	X	ID of delivery template
templateParameter	Object	X	Replacement parameter (to enter mail title/body for replacement)
- #key#	String	X	Replacement key (##key##)
- #value#	Object	X	Mapped value for replacement key
receiverList	List	O	List of recipients Send up to 1,000 persons (including recipients and cc recipients)
- receiveMailAddr	String	O	Recipient's email address
- receiveName	String	X	Recipient's name
- receiveType	String	O	Recipient type (MRT0: recipient , MRT1: Cc, MRT2: Bcc)
customHeaders	Map	X	Custom Header
senderGroupingKey	String	X	Sender's group key
userId	String	X	Delimiter of delivery e.g.) admin, system

[Caution]

On a template, senderAddress, title, and body are not required. These values, if left empty, can be replaced by registered values on template.
On a template, senderAddress, senderName, title, body, and templateType, if available, are applied before template-registered values.

[Example 1]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/mail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "senderAddress": "support@example.com",
    "senderName": "발송자이름",
    "title": "샘플 타이틀",
    "body": "샘플 내용",
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1",
            "receiveType": "MRT0"
        }, {
            "receiveMailAddr": "customer2@example.com",
            "receiveName": "고객2",
            "receiveType": "MRT1"
        }
    ],
    "userId": "USER"
}'

[Example 2 - Using Templates]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/mail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "templateId": "TEMPLATE1",
    "templateParameter": {
        "key": "value"
    },
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1",
            "receiveType": "MRT0"
        }, {
            "receiveMailAddr": "customer2@example.com",
            "receiveName": "고객2",
            "receiveType": "MRT1"
        }
    ],
    "userId": "USER"
}'

Response

{
    "header": {
        "resultCode": 0,
        "resultMessage": "success",
        "isSuccessful": true
    },
    "body": {
        "data": {
            "requestId": "20190101000000ABCDEFG0",
            "results": [
                {
                    "receiveMailAddr": "receiver@nhn.com",
                    "receiveName": "receiver",
                    "receiveType": "MRT0",
                    "resultCode": 0,
                    "resultMessage": "success"
                }
            ]
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- requestId	String	Request ID
-- results	List	Delivery result
--- receiveMailAddr	String	Recipient's mail address
--- receiveName	String	Recipient's name
--- receiveType	String	Recipient type (MRT0: recipients , MRT1: Cc, MRT2: Bcc)
--- resultCode	Integer	Result code of recipient delivery request
--- resultMessage	String	Result message of recipient delivery request

Updated for v1.6

When values are entered as requested on a template, user's request is applied before template.

Send Individual Mails

Mails can be sent to each of many recipients. Even if a same mail is sent to many recipients, each recipient can find his or her name only.

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/sender/eachMail

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Request Body]

Value	Type	Required	Description
senderAddress	String	O	Sender's mail
senderName	String	X	Sender's name
requestDate	String	X	Enter current time when delivery time is missing (yyyy-MM-dd HH:mm:ss)
title	String	O	Title
body	String	O	Body
attachFileIdList	List:Integer	X	ID for uploaded attached file
templateType	String	X	Template type DEFAULT(default), FREEMARKER)
templateId	String	X	ID for delivery template
receiverList	List	O	List of recipients Send up to 1,000 persons
- receiveMailAddr	String	O	Recipient's mail address
- receiveName	String	X	Recipient's name
- templateParameter	Object	X	Replacement parameter (to enter mail title/body for replacement)
-- #key#	String	X	Replacement key (##key##)
-- #value#	Object	X	Mapped value for replacement key
customHeaders	Map	X	Custom Header
senderGroupingKey	String	X	Sender's group key
userId	String	X	Delimiter for delivery e.g.) admin,system

[Caution]

On a template, senderAddress, title, and body are not required. These values, if left empty, can be replaced by registered values on template.
On a template, senderAddress, senderName, title, body, and templateType, if available, are applied before template-registered values.

[Example 1]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/eachMail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "senderAddress": "support@example.com",
    "senderName": "발송자이름",
    "title": "샘플 타이틀",
    "body": "샘플 내용",
    "attachFileIdList": [1, 2],
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1"
        }
    ],
    "userId": "USER"
}'

[Example 2 - Using Templates]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/eachMail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "templateId": "TEMPLATE1",
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1",
            "templateParameter": {
                "key": "value"
            }
        }
    ],
    "userId": "USER"
}'

Response

{
    "header": {
        "resultCode": 0,
        "resultMessage": "success",
        "isSuccessful": true
    },
    "body": {
        "data": {
            "requestId": "20190101000000ABCDEFG0",
            "results": [
                {
                    "receiveMailAddr": "receiver@nhn.com",
                    "receiveName": "receiver",
                    "receiveType": "MRT0",
                    "resultCode": 0,
                    "resultMessage": "success"
                }
            ]
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- requestId	String	Request ID
-- results	List	Delivery result
--- receiveMailAddr	String	Recipient's mail address
--- receiveName	String	Recipient's name
--- receiveType	String	Recipient type (MRT0: recipients , MRT1: Cc, MRT2: Bcc)
--- resultCode	Integer	Result code of recipient delivery request
--- resultMessage	String	Result message of recipient delivery request

Updated for v1.6

When values are entered as requested on a template, user's request is applied before template.

Sending General Ad Mails

Request and response information is same as in sending general mails.

Caution for Sending Ad Mails

The title must include the (AD) phrase.
For more details, see Send Advertising Mails.

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/sender/ad-mail

[Example 1]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/ad-mail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "senderAddress": "support@example.com",
    "senderName": "발송자이름",
    "title": "(광고) 샘플 타이틀",
    "body": "샘플 내용 <br /> ##BLOCK_RECEIVER_LINK## <br />##EN_BLOCK_RECEIVER_LINK##",
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1",
            "receiveType": "MRT0"
        }, {
            "receiveMailAddr": "customer2@example.com",
            "receiveName": "고객2",
            "receiveType": "MRT1"
        }
    ],
    "userId": "USER"
}'

[Example 2 - Using Templates]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/ad-mail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "templateId": "TEMPLATE1",
    "templateParameter": {
        "key": "value"
    },
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1",
            "receiveType": "MRT0"
        }, {
            "receiveMailAddr": "customer2@example.com",
            "receiveName": "고객2",
            "receiveType": "MRT1"
        }
    ],
    "userId": "USER"
}'

Sending Individual Ad Mails

Request and response information is same as in sending individual mails.

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/sender/ad-eachMail

[Example 1]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/ad-eachMail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "senderAddress": "support@example.com",
    "senderName": "발송자이름",
    "title": "(광고) 샘플 타이틀",
    "body": "샘플 내용 <br /> ##BLOCK_RECEIVER_LINK## <br />##EN_BLOCK_RECEIVER_LINK##",
    "attachFileIdList": [1, 2],
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1"
        }
    ],
    "userId": "USER"
}'

[Example 2 - Using Templates]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/ad-eachMail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "templateId": "TEMPLATE1",
    "receiverList": [{
            "receiveMailAddr": "customer1@example.com",
            "receiveName": "고객1",
            "templateParameter": {
                "key": "value"
            }
        }
    ],
    "userId": "USER"
}'

Send Authenticated Mails

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/sender/auth-mail

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Request Body]

Value	Type	Required	Description
senderAddress	String	O	Sender's address
senderName	String	X	Sender's name
requestDate	String	X	Enter current time when delivery time is missing (yyyy-MM-dd HH:mm:ss)
title	String	O	Title
body	String	O	Body
templateId	String	X	ID for delivery template
receiver	Object	O	Recipient
- receiveMailAddr	String	O	Recipient's mail address
- receiveName	String	X	Recipient's name
- templateParameter	Object	X	Replacement parameter (to enter mail title/body for replacement)
-- #key#	String	X	Replacement key (##key##)
-- #value#	Object	X	Mapped value for replacement key
customHeaders	Map	X	Custom Header
userId	String	X	Delimiter for delivery e.g.) admin,system

[Caution]

On a template, senderAddress, title, and body are not required. These values, if left empty, can be replaced by registered values on template.
On a template, senderAddress, senderName, title, body, and templateType, if available, are applied before template-registered values.

Differences from General Mails

Features of authenticated mails are as follows:

Allows only single-case deliveries (one recipient).
File attachment is not supported. Templates including attachment are not supported.

[Example 1]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/auth-mail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "senderAddress": "support@example.com",
    "senderName": "발송자이름",
    "title": "샘플 타이틀",
    "body": "샘플 내용",
    "receiver": {
        "receiveMailAddr": "customer1@example.com",
        "receiveName": "고객1"
    },
    "userId": "USER"
}'

[Example 2 - Using Templates]

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/auth-mail' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "templateId": "TEMPLATE1",
    "receiver": {
        "receiveMailAddr": "customer1@example.com",
        "receiveName": "고객1",
        "templateParameter": {
            "key": "value"
        }
    },
    "userId": "USER"
}'

Response

{
    "header": {
        "resultCode": 0,
        "resultMessage": "success",
        "isSuccessful": true
    },
    "body": {
        "data": {
            "requestId": "20190101000000ABCDEFG0",
            "results": [
                {
                    "receiveMailAddr": "receiver@nhn.com",
                    "receiveName": "receiver",
                    "receiveType": "MRT0",
                    "resultCode": 0,
                    "resultMessage": "success"
                }
            ]
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- requestId	String	Request ID
-- results	List	Delivery result
--- receiveMailAddr	String	Recipient's mail address
--- receiveName	String	Recipient's name
--- receiveType	String	Recipient type (MRT0: recipients , MRT1: Cc, MRT2: Bcc)
--- resultCode	Integer	Result code of recipient delivery request
--- resultMessage	String	Result message of recipient delivery request
### Upload Attached Files

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/attachfile/binaryUpload

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Request Body]

Value	Type	Required	Description
fileName	String	O	File name
fileBody	Byte[]	O	Byte[] of a file
createUser	String	X	File uploader information

cURL

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/attachfile/binaryUpload' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "fileName": "file.csv",
    "createUser": "USER",
    "fileBody": []
}'

Response

{
  "header": {
    "isSuccessful":  Boolean,
    "resultCode": Integer,
    "resultMessage": String
  },
  "body": {
    "data": {
      "fileId": Integer,
      "fileName": String
    }
  }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- fileId	Integer	File ID
-- fileName	String	File name

Title/Body Replacement

Default Type

Enter in the (##Replacement Key##) format to replace with user-defined templateParameter.

* title: Hello, ##title_name## !!
* body: We send ##body_content##.
->
* title: Hello, clouc customer1 !!
* body: We send test2.

FreeMarker Type

FreeMarker Template Engine is supported.
You may use a template language to replace with user-defined templateParameter.

* title: Hello, ${title_name}!!
* body: We send ${body_content}.
->
* title: Hello, cloud customer1!!
* body: We send test2.

Example of General Mail Request

{
    "senderAddress" : "support@nhnent.com",
    "templateId": "template1",
    "templateParameter" : {"title_name": "cloud customer1", "body_content": "test1"},
    "receiverList" : [
        {
            "receiveMailAddr" : "customer1@nhnent.com",
            "receiveType" : "MRT0"
        }

    ],
    "userId" : "tester"
}

Example of Individual Mail Request

{
    "senderAddress" : "support@nhnent.com",
    "templateId": "template1",
    "receiverList" : [
        {
            "receiveMailAddr" : "customer1@nhnent.com",
            "templateParameter" : {"title_name": "cloud customer1", "body_content": "test1"}
        },
        {
            "receiveMailAddr" : "customer2@nhnent.com",
            "templateParameter" : {"title_name": "cloud customer2", "body_content": "test2"}
        }

    ],
    "userId" : "tester"
}

Query of Mails

Query List of Mail Deliveries

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/sender/mails

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Query Parameter]

Value	Type	Required	Description
requestId	String	O	Request ID
startSendDate	String	O	Delivery start date (yyyy-MM-dd HH:mm:ss)
endSendDate	String	X	Delivery end date (yyyy-MM-dd HH:mm:ss)
startReceiveDate	String	X	Receiving start date (yyyy-MM-dd HH:mm:ss)
endReceiveDate	String	X	Receiving end date (yyyy-MM-dd HH:mm:ss)
senderAddress	String	X	Sender's mail address
senderName	String	X	Sender's name
receiveMailAddr	String	X	Recipient's mail address
templateId	String	X	Template number
mailStatusCode	String	X	Delivery status code SST0: Preparing for sending, SST1: Sending, SST2: Sending completed, SST3: Sending failed, SST7: Not Authenticated
isReceived	Boolean	X	Received or Not
isOpened	Boolean	X	Opened or Not
senderGroupingKey	String	X	Sender's group key
pageNum	Integer	X	Page number (default: 1)
pageSize	Integer	X	Number of queries (default: 15)

requestId, or startSendDate and endSendDate are required fields.

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/mails?startSendDate='"${START_DATE}"'&endSendDate='"${END_DATE}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
    "header": {
        "isSuccessful": true,
        "resultCode": 0,
        "resultMessage": "SUCCESS"
    },
    "body": {
        "pageNum": 1,
        "pageSize": 10,
        "totalCount": 1,
        "data": [
            {
                "requestId": "20190101000000ABCDEFG0",
                "mailSeq": 0,
                "requestDate": "2019-01-01 00:00:00",
                "templateId": "Template",
                "templateName": "Template Name",
                "senderName": "Sender",
                "senderAddress": "sender@nhn.com",
                "title": "Title",
                "mailStatusCode": "SST2",
                "mailStatusName": "발송완료",
                "isReceived": true,
                "resultDate": "2019-01-01 00:00:00",
                "isOpened": true,
                "openedDate": "2019-01-01 00:00:00",
                "receiveMailAddr": "receiver@nhn.com",
                "receiveType": "MRT0",
                "receiveTypeName": "받는사람",
                "receiveName": "Receiver",
                "senderGroupingKey": "A_GROUP"
            }
        ]
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- pageNum	Integer	Current page number
- pageSize	Integer	Number of queried data
- totalCount	Integer	Number of total data
- data	List	Data area
-- requestId	String	Request ID
-- mailSeq	String	Mail sequence
-- requestDate	String	Date and time of sending
-- templateId	String	Template ID
-- templateName	String	Template name
-- senderName	String	Sender's name
-- senderAddress	String	Sender's mail address
-- title	String	Title
-- mailStatusCode	String	Delivery status code SST0: Preparing Delivery, SST1: Delivering, SST2: Delivery Completed, SST3: Delivery Failed, SST7: Not Authenticated
-- mailStatusName	String	Name of delivery status
-- isReceived	Boolean	Received or Not
-- resultDate	String	Date and Time of Receiving
-- isOpened	Boolean	Opened or Not
-- openedDate	String	Date and Time of Opening
-- receiveMailAddr	String	Recipient's mail address
-- receiveType	String	Recipient type (MRT0: recipient, MRT1: cc, MRT2: bcc)
-- receiveTypeName	String	Name of recipient type
-- receiveName	String	Name of recipient
-- senderGroupingKey	String	Sender's group key

Query Mail Delivery Details

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/sender/mail/{requestId}/{mailSeq}

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey
requestId	String	Request ID
mailSeq	Integer	Mail sequence

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/mail/'"${REQUEST_ID}"'/'"${MAIL_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
    "header": {
        "isSuccessful": true,
        "resultCode": 0,
        "resultMessage": "SUCCESS"
    },
    "body": {
        "data": {
            "requestId": "20190101000000ABCDEFG0",
            "mailSeq": 0,
            "requestIp": "127.0.0.1",
            "requestDate": "2019-01-01 00:00:00",
            "mailStatusCode": "SST2",
            "mailStatusName": "발송완료",
            "templateId": "Template",
            "templateName": "Template Name",
            "senderName": "Sender",
            "senderAddress": "sender@nhn.com",
            "resultId": "<20190101000000ABCDEFG0@test>",
            "title": "Title",
            "body": "Body",
            "receiverList": [
                {
                    "requestId": "20190101000000ABCDEFG0",
                    "mailSeq": 0,
                    "receiveType": "MRT0",
                    "receiveTypeName": "받는사람",
                    "receiveName": "Receiver",
                    "receiveMailAddr": "receiver@nhn.com",
                    "isReceived": true,
                    "resultDate": "2019-01-01 00:00:00",
                    "isOpened": true,
                    "openedDate": "2019-01-01 00:00:00"
                }
            ],
            "attachFileList": [
                {
                    "fileType": "MAIL",
                    "fileId": 1,
                    "fileName": "test.jpg",
                    "filePath": "file/path",
                    "fileSize": 1,
                    "createDate": "2019-01-01 00:00:00"
                }
            ],
            "customHeaders": {
                "Content-Type": "text/html"
            },
            "senderGroupingKey": "A_GROUP"
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- requestId	String	Request ID
-- mailSeq	Integer	Mail sequence
-- requestIp	String	Request IP
-- requestDate	String	Date and time of requesting
-- mailStatusCode	String	Delivery status
-- mailStatusName	String	Name of delivery status
-- templateId	String	Template ID
-- templateName	String	Template name
-- senderName	String	Sender's name
-- senderAddress	String	Sender's mail address
-- resultId	String	Mail delivery ID
-- title	String	Mail title
-- body	String	Mail body
-- receiverList	List	List of recipients
--- requestId	String	Request ID
--- mailSeq	Integer	Mail sequence
--- receiveType	String	Recipient type MRT0: to , MRT1: cc, MRT2: bcc
--- receiveTypeName	String	Name of recipient type
--- receiveName	String	Recipient's name
--- receiveMailAddr	String	Recipient's mail address
--- isReceived	Boolean	Received or Not
--- resultDate	String	Date and Time of Receiving
--- isOpened	Boolean	Opened or Not
--- openedDate	String	Date and Time of Opening
-- attachFileList	List	List of attached files
--- fileType	String	Type of attached files MAIL: files attached to mail, TEMPLATE: files attached to template
--- fileId	Integer	File ID
--- fileName	String	Name of attached file
--- filePath	String	Path of attached file
--- fileSize	Integer	Size of attached file (byte)
--- createDate	String	Date and time of creation
-- customHeaders	Map	Custom Header
-- senderGroupingKey	String	Sender's group key
## Scheduled Delivery Management

List Scheduled Delivery

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/sender/reservations

[Path parameter]

Value	Type	Description
appKey	String	Original appKey

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/reservations' \
-H 'Content-Type: application/json;charset=UTF-8'

[Query parameter]

Value	Type	Required	Description
requestId	String	X	Request ID
startSendDate	String	X	Start date of sending (yyyy-MM-dd HH:mm:ss)
endSendDate	String	X	End date of sending (yyyy-MM-dd HH:mm:ss)
senderMail	String	X	Sender's mail address
receiveMail	String	X	Recipient's mail address
templateId	String	X	Template ID
pageNum	Integer	X	Page number (default: 1)
pageSize	Integer	X	Number of queries (default: 15)

Response

{
   "header":{
      "isSuccessful":true,
      "resultCode":0,
      "resultMessage":"SUCCESS"
   },
   "body":{
      "totalCount":1,
      "pageNum": 1,
      "pageSize": 15,
      "data":[
         {
            "requestId":"20200605175300tu5z04e1",
            "mailSeq":0,
            "title":"Title",
            "templateId":"TemplateId",
            "templateName":"TemplateName",
            "senderAddress":"sender@example.com",
            "senderName":"senderName",
            "receiveMailAddr":"receiver@example.com",
            "receiveName":"receiverName",
            "receiveType":"MRT0",
            "receiveTypeName":"받는사람",
            "requestDate":"2020-06-05 17:53:00",
            "mailStatusCode":"SST4",
            "mailStatusName":"예약대기",
            "senderGroupingKey":"senderKey"
         }
      ]
   }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- pageNum	Integer	Current page number
- pageSize	Integer	Number of queried data
- totalCount	Integer	Number of total data
- data	List	Data area
-- requestId	String	Request ID
-- mailSeq	Integer	Mail sequence
-- title	String	Title
-- templateId	String	Template ID
-- templateName	String	Template name
-- senderAddress	String	Sender's mail address
-- senderName	String	Sender's name
-- receiveMailAddr	String	Recipient's mail address
-- receiveName	String	Name of recipient
-- receiveType	String	Recipient type (MRT0: recipient, MRT1: cc, MRT2: bcc)
-- receiveTypeName	String	Name of recipient type
-- requestDate	String	Date and time of sending
-- mailStatusCode	String	Delivery status code SST0: Preparing Delivery, SST1: Delivering SST2: Delivery Completed, SST3: Delivery Failed SST4: Scheduled Waiting, SST7: Not Authenticated
-- mailStatusName	String	Name of delivery status
-- senderGroupingKey	String	Sender's group key

Query Detail Scheduled Delivery

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/sender/reservations/{requestId}/{mailSeq}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
requestId	String	Request ID
mailSeq	Integer	Mail sequence

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/reservations/'"${REQUEST_ID}"'/'"${MAIL_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
   "header":{
      "isSuccessful":true,
      "resultCode":0,
      "resultMessage":"SUCCESS"
   },
   "body":{
      "data":{
         "requestId":"202006050000008j6bx5Q1",
         "mailSeq":0,
         "title":"Title",
         "body":"Body",
         "templateId": "TemplateId",
         "templateName":"TemplateName",
         "senderAddress":"sender@example.com",
         "senderName":"senderName",
         "requestDate":"2020-06-05 00:00:00",
         "mailStatusCode":"SST4",
         "mailStatusName":"예약대기",
         "receivers":[
            {
               "requestId":"202006050000008j6bx5Q1",
               "mailSeq":0,
               "receiveType":"MRT0",
               "receiveTypeName":"받는사람",
               "receiveName":"receiverName",
               "receiveMailAddr":"receiver@example.com"
            }
         ],
         "attachFileList":[
            {
               "fileType":"Mail",
               "fileId": 123456,
               "fileName":"attachement.jpg",
               "filePath":"28578/toast-mt-2020-06-03/2344/183037",
               "fileSize":8074,
               "createDate":"2020-06-03 23:44:27"
            }
         ],
         "customHeaders":{
                "Content-Type": "text/html"
         },
         "senderGroupingKey":"senderKey"
      }
   }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolea{}n	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- requestId	String	Request ID
-- mailSeq	Integer	Mail sequence
-- title	String	Mail title
-- body	String	Mail body
-- templateId	String	Template ID
-- templateName	String	Template name
-- senderAddress	String	Sender's mail address
-- senderName	String	Sender's name
-- requestDate	String	Date and time of sending
-- mailStatusCode	String	Delivery status code SST0: Preparing Delivery, SST1: Delivering SST2: Delivery Completed, SST3: Delivery Failed SST4: Scheduled Waiting, SST7: Not Authenticated
-- mailStatusName	String	Name of delivery status
-- receiverList	List	List of recipients
--- requestId	String	Request ID
--- mailSeq	Integer	Mail sequence
--- receiveType	String	Recipient type (MRT0: recipient, MRT1: cc, MRT2: bcc)
--- receiveName	String	Name of recipient
--- receiveTypeName	String	Name of recipient type
--- receiveMailAddr	String	Recipient's mail address
-- attachFileList	List	List of attached files
--- fileType	String	Type of attached files MAIL: files attached to mail, TEMPLATE: files attached to template
--- fileId	Integer	File ID Attachments uploaded through the v1.0, v1.1 APIs are marked with a file ID value of -1
--- fileName	String	Name of attached file
--- filePath	String	Path of attached file
--- fileSize	Integer	Size of attached file (byte)
--- createDate	String	Date and time of creation
-- customHeaders	Map	Custom Header
-- senderGroupingKey	String	Sender's group key

Cancel Scheduled Delivery by Request

Request

[URL]

Http method	URI
PUT	/email/v1.6/appKeys/{appKey}/sender/reservations/{requestId}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
requestId	String	Request ID

cURL

curl -X PUT \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/reservations/'"${REQUEST_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Cancel Scheduled Delivery by recipient

Request

[URL]

Http method	URI
PUT	/email/v1.6/appKeys/{appKey}/sender/reservations/{requestId}/{mailSeq}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
requestId	String	Request ID
mailSeq	Integer	Mail sequence

cURL

curl -X PUT \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/reservations/'"${REQUEST_ID}"'/'"${MAIL_SEQ}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Cancel Scheduled Delivery - Multiple Filter

Request

[URL]

Http method	URI
PUT	/email/v1.6/appKeys/{appKey}/sender/reservations/search-cancels

[Path parameter]

Value	Type	Description
appKey	String	Original appkey

[Request body]

{
    "searchParameter" : {
        "requestId" : "202006051209288SxRXhejd20",
        "startSendDate" : "2020-02-01 00:00",
        "endSendDate" : "2020-02-01 10:00",
        "senderMail" : "sender@example.com",
        "receiveMail" : "receiver@example.com",
        "templateId" : "templateId"
    },
    "updateUser" : "UpdateUser"
}

Value	Type	Required	Description
searchParameter.requestId	String	X	Request ID
searchParameter.startSendDate	String	O	Start date of delivery (yyyy-MM-dd HH:mm:ss)
searchParameter.endSendDate	String	O	End date of delivery (yyyy-MM-dd HH:mm:ss)
searchParameter.senderMail	String	X	Sender's mail address
searchParameter.receiveMail	String	X	Recipient's mail address
searchParameter.templateId	String	X	Template ID
updateUser	String	O	Requester of Scheduled Cancellation

startSendDate, endSendDate, updateUser are required fields.

cURL

curl -X PUT \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/reservations/search-cancels' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "searchParameter": {
        "requestId": "202006051209288SxRXhejd20",
        "startSendDate": "2020-02-01 00:00",
        "endSendDate": "2020-02-01 10:00",
        "senderMail": "sender@example.com",
        "receiveMail": "receiver@example.com",
        "templateId": "templateId"
    },
    "updateUser": "UpdateUser"
}'

Response

{
    "header" : {
        "resultCode" : 0,
        "resultMessage" : "success",
        "isSuccessful" : true
    },
    "body" : {
        "data" : {
            "reservationCancelId" : "202006051209288SxRXhejd20",
            "requestedDateTime" : "2020-06-05 16:09:24",
            "reservationCancelStatus" : "READY"
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- reservationCancelId	String	Schedule Cancellation ID
-- requestedDateTime	String	Time for Schedule Cancellation(yyyy-MM-dd HH:mm:ss)
-- 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]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/sender/reservations/search-cancels

[Path parameter]

Value	Type	Description
appKey	String	Original appkey

[Query parameter]

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

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/sender/reservations/search-cancels' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
    "header" : {
        "resultCode" : 0,
        "resultMessage" : "success",
        "isSuccessful" : true
    },
    "body" : {
        "pageNum" : 1,
        "pageSize" : 15,
        "totalCount" : 1,
        "data" : [
            {
                "reservationCancelId" : "202006051209288SxRXhejd20",
                "searchParameter" : {
                    "serviceId" : 12345,
                    "requestId" : "2020060asdasd8SxRXhejd20",
                    "startSendDate" : "2020-06-01 00:00:00",
                    "endSendDate" : "2020-06-11 00:00:00",
                    "senderMail" : "sender@example.com",
                    "receiveMail" : "receiver@example.com",
                    "templateId" : "templateId",
                    "sendStatus" : null,
                    "searchedBySendDate" : true
                },
                "requestedDateTime" : "2020-06-05 12:09:28",
                "completedDateTime" : "2020-06-05 12:16:05",
                "reservationCancelStatus" : "COMPLETED",
                "totalCount" : 3,
                "successCount" : 3,
                "createUser" : "tester",
                "createdDateTime" : "2020-06-05 12:09:28",
                "updatedDateTime" : "2020-06-05 12:16:05"
            }
        ]
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- pageNum	Integer	Current page number
- pageSize	Integer	Number of queried data
- totalCount	Integer	Number of total data
- data	List	Data area
-- reservationCancelId	String	Schedule Cancellation ID
-- searchParameter	Map	Request Parameter for Schedule Cancellation
-- requestedDateTime	String	Request Time for Schedule Cancellation
-- completedDateTime	String	Request End Time for Schedule Cancellation
-- reservationCancelStatus	String	Status of Schedule Cancellation - READY : Preparing for Scheduling - PROCESSING : Cancelling Schedule - COMPLETED : Schedule Cancellation Completed - FAILED : Schedule Cancellation Failed
-- totalCount	Integer	Number of Scheduled Cancellation Targets
-- successCount	Integer	Number of Successful Schedule Cancellation
-- createUser	String	Requester of Scheduled Cancellation
-- createdDateTime	String	Request Creation Time for Schedule Cancellation
-- updatedDateTime	String	Modified Time for Scheduled Cancellation

Category Management

List

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/categories

[Path parameter]

Value	Type	Description
appKey	String	Original appKey

[Query parameter]

Value	Type	Required	Description
useYn	String	X	Use or Not: Y, N
categoryParentId	Integer	X	Parent category ID
pageNum	Integer	X	Page number (default: 1)
pageSize	Integer	X	Number of queries (default: 15)

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/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": 3,
        "data": [
            {
                "categoryId": 12345,
                "categoryParentId": 0,
                "depth": 0,
                "categoryName": "Category",
                "categoryDesc": "Top Category",
                "useYn": "Y",
                "createUser": "user",
                "createDate": "2019-07-23 00:00:00.0",
                "updateUser": "user",
                "updateDate": "2019-07-23 00:00:00.0"
            }
        ]
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- pageNum	Integer	Current page number
- pageSize	Integer	Queried data count
- totalCount	Integer	Total data count
- data	List	Data area
-- categoryId	Integer	Category ID
-- categoryParentId	Integer	Parent category ID (0, for the highest-level category)
-- depth	Integer	Depth (0, for the highest-level category)
-- categoryName	String	Category name
-- categoryDesc	String	Category description
-- useYn	String	Use or not
-- createUser	String	Creator
-- createDate	String	Date and time of creation
-- updateUser	String	Modifier
-- updateDate	String	Date and time of modification

Query Details

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/categories/{categoryId}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
categoryId	String	Category ID

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/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": 12345,
            "categoryParentId": 0,
            "depth": 0,
            "categoryName": "Category",
            "categoryDesc": "Top Category",
            "useYn": "Y",
            "createUser": "user",
            "createDate": "2019-07-23 00:00:00.0",
            "updateUser": "user",
            "updateDate": "2019-07-23 00:00:00.0"
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	List	Data area
-- categoryId	Integer	Category ID
-- categoryParentId	Integer	Parent category ID (0, for the highest-level category)
-- depth	Integer	Depth (0, for the highest-level category)
-- categoryName	String	Category name
-- categoryDesc	String	Category description
-- useYn	String	Use or not
-- createUser	String	Creator
-- createDate	String	Date and time of creation
-- updateUser	String	Modifier
-- updateDate	String	Date and time of modification

Register

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/categories

[Path parameter]

Value	Type	Description
appKey	String	Original appKey

[Request body]

Value	Type	Max Length	Required	Description
categoryParentId	Integer	-	X	Parent category ID Highest-level category ID (default)
categoryName	String	200	O	Category name
categoryDesc	String	1000	X	Category description
useYn	String	1	X	Use or not: Y (default), N
userId	String	50	X	User ID

cURL

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/categories'
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "categoryParentId": 12345,
    "categoryName": "Category",
    "categoryDesc": "Top Category",
    "useYn": "Y",
    "userId": "USER"
}'

Response

{
    "header": {
        "isSuccessful": true,
        "resultCode": 0,
        "resultMessage": "SUCCESS"
    },
    "body": {
        "data": {
            "categoryId": 12346
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- categoryId	Integer	Cateogry ID

Modify

Request

[URL]

Http method	URI
PUT	/email/v1.6/appKeys/{appKey}/categories/{categoryId}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
categoryId	Integer	Category ID

[Request body]

Value	Type	Max Length	Required	Description
categoryName	String	200	X	Category name
categoryDesc	String	1000	X	Category description
useYn	String	1	X	Use or not: Y, N
userId	String	50	X	User ID

cURL

curl -X PUT \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/categories/'"${CATEGORY_ID}" \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "categoryName": "Category",
    "categoryDesc": "Top Category",
    "useYn": "Y",
    "userId": "USER"
}'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Delete

Request

[URL]

Http method	URI
DELETE	/email/v1.6/appKeys/{appKey}/categories/{categoryId}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
categoryId	Integer	Category ID

cURL

curl -X DELETE \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/categories/'"${CATEGORY_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Query of Templates

Query List of Templates

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/templates

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Query Parameter]

Value	Type	Required	Description
categoryId	Integer	X	Category ID
useYn	String	X	Use or Not (Y/N)
pageNum	Integer	X	Page number (default: 1)
pageSize	Integer	X	Number of queries (default: 15)
all	Boolean	X	Query list of all templates or not

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/templates' \
-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": "TEMPLATE",
                "categoryId": 12345,
                "categoryName": "Category",
                "templateName": "Template",
                "templateDesc": "Template",
                "useYn": "Y",
                "delYn": "N",
                "title": "Title",
                "createDate": "2019-01-01 00:00:00.0",
                "updateDate": "2019-01-01 00:00:00.0"
            }
        ]
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- pageNum	Integer	Current page number
- pageSize	Integer	Number of queried data
- totalCount	Integer	Total number of data
- data	List	Data area
-- templateId	String	Template ID
-- categoryId	Integer	Category ID
-- categoryName	String	Category name
-- templateName	String	Template name
-- templateDesc	String	Template description
-- useYn	String	Use or not
-- delYn	String	Delete or not
-- title	String	Title
-- createDate	String	Date and time of creation
-- updateDate	String	Date and time of modification

Query Template Details

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/templates/{templateId}

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey
templateId	String	Template ID

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/templates/'"${TEMPLATE_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
    "header": {
        "resultCode": 0,
        "resultMessage": "success",
        "isSuccessful": true
    },
    "body": {
        "data": {
            "templateId": "TEMPLATE",
            "categoryId": 12345,
            "categoryName": "Category",
            "templateName": "Template",
            "templateDesc": "Template",
            "useYn": "Y",
            "delYn": "N",
            "sendMailAddress": "test@nhn.com",
            "title": "Title",
            "templateType": "DEFAULT",
            "body": "Body",
            "createDate": "2019-01-01 00:00:00.0",
            "updateDate": "2019-01-01 00:00:00.0",
            "attachFileList": [
                {
                    "fileType": "TEMPLATE",
                    "fileId": 12345,
                    "fileName": "test.csv",
                    "filePath": "file/path",
                    "fileSize": 10,
                    "createDate": "2019-01-01 00:00:00.0"
                }
            ]
        }
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	List	Data area
-- templateId	String	Template ID
-- categoryId	Integer	Category ID
-- categoryName	String	Category name
-- templateName	String	Template name
-- templateDesc	String	Template description
-- useYn	String	Use or not (Y= In use, N= Not in use)
-- delYn	String	Delete or not (Y= Delete, N= Not delete)
-- sendMailAddress	String	Sender's mail address
-- title	String	Mail address
-- templateType	String	Template type DEFAULT(default), FREEMARKER)
-- body	String	Body
-- createDate	String	Date and time of creation
-- updateDate	String	Date and time of modification
-- attachFileList	List	List of attached files
--- fileType	String	Attachment type (MAIL: Files attached to mail, TEMPLATE: Files attached to template)
--- fileId	Integer	File ID
--- fileName	String	Name of attached file
--- filePath	String	Path of attached file
--- fileSize	Integer	Size of attached file (byte)
--- createDate	String	Date and time of creation

Register Templates

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/templates

[Path parameter]

Value	Type	Description
appKey	String	Original appKey

[Request body]

Value	Type	Max Length	Required	Description
categoryId	Integer	-	O	Category ID
templateId	String	50	O	Template ID
templateName	String	200	O	Template name
templateDesc	String	4000	X	Template description
useYn	String	1	X	Use or not: Y (default), N
sendMailAddress	String	300	O	Sender's mail address
title	String	500	O	Mail title
templateType	String	10	X	Template type DEFAULT (default), FREEMARKER
body	String	-	O	Mail body
attachFileIdList	List	-	X	Attached file ID (fileId)
userId	String	50	X	User ID

cURL

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/templates' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "categoryId": 1,
    "templateId": "TEAMPLTE_ID",
    "templateName": "템플릿 이름",
    "templateDesc": "템플릿 설명",
    "useYn": "Y",
    "sendMailAddress": "test@example.com",
    "title": "메일 제목",
    "templateType": "DEFAULT",
    "body": "메일 내용",
    "attachFileIdList": [1, 2, 3],
    "userId": "USER"
}'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Upload Attached Files

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/templates/attachfile/binaryUpload

[Path parameter]

Value	Type	Description
appKey	String	Original appKey

[Request body]

Value	Type	Max Length	Required	Description
fileName	String	-	O	File name
fileBody	Byte[]	-	O	Byte [] value
userId	String	50	X	User ID

cURL

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/templates/attachfile/binaryUpload' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "fileName": "file.csv",
    "userId": "USER",
    "fileBody": []
}'

Response

{
  "header": {
    "isSuccessful":  true,
    "resultCode": 0,
    "resultMessage": "SUCCESS"
  },
  "body": {
    "data": {
      "fileId": 1,
      "fileName": "file.csv"
    }
  }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	Object	Data area
-- fileId	Integer	File ID
-- fileName	String	File name

Modify Templates

Request

[URL]

Http method	URI
PUT	/email/v1.6/appKeys/{appKey}/templates/{templateId}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
templateId	String	Template ID

[Request body]

Value	Type	Max Length	Required	Description
templateName	String	200	X	Template name
templateDesc	String	4000	X	Template description
useYn	String	1	X	Use or not: Y, N
sendMailAddress	String	300	X	Sender's mail address
title	String	500	X	Mail title
templateType	String	10	X	Template type DEFAULT (default), FREEMARKER
body	String	-	X	Mail body
attachFileIdList	List	-	X	Attached file ID (fileId)
userId	String	50	X	User ID

cURL

curl -X PUT \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/templates/'"${TEMPLATE_ID}" \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "templateName": "템플릿 이름",
    "templateDesc": "템플릿 설명",
    "useYn": "Y",
    "sendMailAddress": "test@example.com",
    "title": "메일 제목",
    "templateType": "DEFAULT",
    "body": "메일 내용",
    "attachFileIdList": [1, 2, 3],
    "userId": "USER"
}'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Delete Templates

Request

[URL]

Http method	URI
DELETE	/email/v1.6/appKeys/{appKey}/templates/{templateId}

[Path parameter]

Value	Type	Description
appKey	String	Original appKey
templateId	String	Template ID

cURL

curl -X DELETE \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/templates/'"${TEMPLATE_ID}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
## Query Statistics

Query Daily Statistics

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/statistics/view

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Query Parameter]

Value	Type	Required	Description
from	String	O	Start date of statistical query yyyy-mm-dd HH:mm
to	String	O	End date of statistical query yyyy-mm-dd HH:mm
searchType	String	O	Statistics Type DATE: By date, TIME: By time, DAY: By day
mailTypes	String	X	Mail Type NORMAL: General, MASS: Mass Multiple inputs are available (mailTypes=NORMAL&mailTypes=MASS)
adYn	String	X	Ad or not Y: Ad, N: Not an ad All, if left blank
templateId	String	X	Template ID

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/statistics/view?from='"${FROM}"'&to='"${TO}"'&searchType='"${SEARCH_TYPE}" \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
    "header": {
        "isSuccessful": true,
        "resultCode": 0,
        "resultMessage": "SUCCESS"
    },
    "body": {
        "data": [
            {
                "divisionName": "Tue",
                "requestedCount": 1,
                "sentCount": 1,
                "receivedCount": 1,
                "openedCount": 0,
                "sentRate": "100.00",
                "receivedRate": "100.00",
                "openedRate": "0.00"
            }
        ]
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- data	List	Data area
-- divisionName	String	Statistical criteria (date/time/day)
-- requestedCount	Long	Number of delivery requests
-- sentCount	Long	Number of deliveries
-- receivedCount	Long	Number of receipts
-- openedCount	Long	Number of openings
-- sentRate	String	Delivery rate
-- receivedRate	String	Receiving rate
-- openedRate	String	Opening rate

Rejection Management

Query Rejections

Request

[URL]

Http method	URI
GET	/email/v1.6/appKeys/{appKey}/block-receivers

[Path Parameter]

Value	Type	Description
appKey	String	Original appKey

[Query Parameter]

Value	Type	Required	Description
mailAddress	String	X	Email address registered on the list of rejections
startBlockDate	String	X	Start date of rejection (yyyy-MM-dd HH:mm:ss)
endBlockDate	String	X	End date of rejection (yyyy-MM-dd HH:mm:ss)
pageNum	Integer	X	Page number (default: 1)
pageSize	Integer	X	Number of queries (default: 15)

cURL

curl -X GET \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/block-receivers' \
-H 'Content-Type: application/json;charset=UTF-8'

Response

{
    "header": {
        "isSuccessful": true,
        "resultCode": 0,
        "resultMessage": "SUCCESS"
    },
    "body": {
        "totalCount": 1,
        "data": [
            {
                "mailAddress": "block@nhn.com",
                "blockDate": "2019-01-01 00:00:00.0"
            }
        ]
    }
}

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message
body	Object	Body area
- pageNum	Integer	Current page number
-pageSize	Integer	Number of queried data
- totalCount	Integer	Total number of data
- data	List	Data area
-- mailAddress	String	Email address to reject
-- blockDate	String	Date of rejection (yyyy-MM-dd HH:mm:ss.S)

Register Rejections

Request

[URL]

Http method	URI
POST	/email/v1.6/appKeys/{appKey}/block-receivers

[Request Body]

Value	Type	Required	Description
blockReceiverList	ㅣList	O	List of rejections
- mailAddress	String	O	Email address to reject
- blockDate	String	X	Date of rejection (yyyy-MM-dd HH:mm:ss)

cURL

curl -X POST \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/block-receivers' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "blockReceiverList": [{
            "mailAddress": "customer1@example.com",
            "blockDate": "2018-03-01 00:00:00"
        }
    ]
}'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Delete Rejections

Request

[URL]

Http method	URI
PUT	/email/v1.6/appKeys/{appKey}/block-receivers

[Request Body]

Value	Type	Required	Description
deleted	Boolean	O	Field specifying rejections are deleted
blockReceiverList	ㅣList	O	List of rejections
- mailAddress	String	O	Email address rejecting ads

cURL

curl -X PUT \
'https://email.api.nhncloudservice.com/email/v1.6/appKeys/'"${APP_KEY}"'/block-receivers' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
    "deleted": true,
    "blockReceiverList": [{
            "mailAddress": "customer1@example.com"
        }
    ]
}'

Response

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

Value	Type	Description
header	Object	Header area
- isSuccessful	Boolean	Successful or not
- resultCode	Integer	Failure code
- resultMessage	String	Failure message

Notification > Email > API v1.6 Guide
Mail Delivery
Send General Mails
Send Individual Mails
Sending General Ad Mails
Sending Individual Ad Mails
Send Authenticated Mails
Title/Body Replacement
Query of Mails
Query List of Mail Deliveries
Query Mail Delivery Details
List Scheduled Delivery
Query Detail Scheduled Delivery
Cancel Scheduled Delivery by Request
Cancel Scheduled Delivery by recipient
Cancel Scheduled Delivery - Multiple Filter
List Request of Scheduled Delivery Cancellation - Multiple Filter
Category Management
List
Query Details
Register
Modify
Delete
Query of Templates
Query List of Templates
Query Template Details
Register Templates
Upload Attached Files
Modify Templates
Delete Templates
Query Daily Statistics
Rejection Management
Query Rejections
Register Rejections
Delete Rejections

TOP