Save a draft message

PUT /api/2.0/mail/drafts/save

Request

Saves a message with the ID specified in the request as a draft.

Authorization

An API key is a token that you provide when making API calls. Include the token in a header parameter called Authorization.

Example: Authorization: 864FE52C-1C1C-469F-9308-51DAFEFE7436.

Headers

Acceptenum of string

Can be one of: application/json.

Content-Typeenum of string

Can be one of: application/json.

Body

idinteger

Message ID which will be saved or 0

fromstring

Mail address from which a letter will be sent. Format: Name <name@domain>

toarray of string

List of mail addresses to which a letter will be sent. Format: Name <name@domain>

ccarray of string

List of Cc (carbon copy) mail addresses. Format: Name <name@domain>

bccarray of string

List of Bcc (blind carbon copy) mail addresses. Format: Name <name@domain>

mimeReplyToIdstring

Message ID to which this message is replying to

importanceboolean

Specifies if this message is important or not: true - important, false - not important

subjectstring

Message subject

tagsarray of integer

List of tag IDs added to the message

bodystring

Message body as the HTML string

attachmentsarray of object

List of message attachments

fileIdintegerformat: int32

fileNamestring

sizeintegerformat: int64

contentTypestring

needSaveToTempboolean

contentIdstring

fileNumberintegerformat: int32

storedNamestring

streamIdstring

attachedAsLinkboolean

tempStoredUrlstring

calendarIcsstring

Calendar event in the iCal format for sending

Examples

PUT /api/2.0/mail/drafts/save HTTP/1.1
Accept: application/json
Content-Length: 423
Content-Type: application/json
Host: example.com

{
  "attachments": [
    {
      "value": {
        "fileId": "1234",
        "fileName": "fileName",
        "size": "1234",
        "contentType": "contentType",
        "needSaveToTemp": "true",
        "contentId": "contentId",
        "fileNumber": "333",
        "storedName": "storedName",
        "streamId": "streamId",
        "attachedAsLink": "true",
        "tempStoredUrl": "tempStoredUrl"
      }
    }
  ]
}

curl --request PUT \
  --url https://example.com/api/2.0/mail/drafts/save \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "attachments": [
    {
      "value": {
        "fileId": "1234",
        "fileName": "fileName",
        "size": "1234",
        "contentType": "contentType",
        "needSaveToTemp": "true",
        "contentId": "contentId",
        "fileNumber": "333",
        "storedName": "storedName",
        "streamId": "streamId",
        "attachedAsLink": "true",
        "tempStoredUrl": "tempStoredUrl"
      }
    }
  ]
}'

Responses

200

Saved message

Attachmentsarray of object

fileIdintegerformat: int32

fileNamestring

sizeintegerformat: int64

contentTypestring

needSaveToTempboolean

contentIdstring

fileNumberintegerformat: int32

storedNamestring

streamIdstring

attachedAsLinkboolean

tempStoredUrlstring

Introductionstring

HtmlBodystring

ContentIsBlockedboolean

Importantboolean

Subjectstring

HasAttachmentsboolean

Bccstring

Ccstring

Tostring

Addressstring

Fromstring

ReplyTostring

Idintegerformat: int32

ChainIdstring

ChainDateStringstring

DateStringstring

DateDisplaystring

TagIdsarray of integer

LabelsInStringstring

IsNewboolean

IsAnsweredboolean

IsForwardedboolean

TextBodyOnlyboolean

Sizeintegerformat: int64

EMLLinkstring

StreamIdstring

RestoreFolderIdenum of integerformat: int32

[0 - Sending, 1 - Inbox, 2 - Sent, 3 - Draft, 4 - Trash, 5 - Spam, 6 - UserFolder, 7 - Templates]

Can be one of: Sending, Inbox, Sent, Draft, Trash, Spam, UserFolder, Templates.

Folderenum of integerformat: int32

[0 - Sending, 1 - Inbox, 2 - Sent, 3 - Draft, 4 - Trash, 5 - Spam, 6 - UserFolder, 7 - Templates]

Can be one of: Sending, Inbox, Sent, Draft, Trash, Spam, UserFolder, Templates.

UserFolderIdarray of integer

ChainLengthintegerformat: int32

WasNewboolean

IsTodayboolean

IsYesterdayboolean

ReceivedDatestring

IsBodyCorruptedboolean

HasParseErrorboolean

MimeMessageIdstring

MimeReplyToIdstring

CalendarUidstring

ReadRequestStatusboolean

401

Unauthorized