# Webhook Event Description
# Request ( request )
参数说明
| parameter | type | description |
|---|---|---|
| event | string | event type: “request” |
| message | string | message content |
| maillistTaskId | long | task ID will be generated when you send emails with address list |
| mail_list_task_id | long | task ID will be generated when you send emails with address list |
| messageId | string | messageId |
| apiUser | string | API_USER |
| category | string | message ID |
| recipientArray | list | recipients |
| emailIds | list | emailId array |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| recipientSize | int | count of requests |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
# Delivery ( deliver )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: “deliver” |
| message | string | message content |
| apiUser | string | API_USER |
| category | string | API_USER |
| maillistTaskId | long | task ID will be generated when you send emails with address list |
| mail_list_task_id | long | task ID will be generated when you send emails with address list |
| emailId | string | unique ID of each email |
| outIp | string | outbound IP address |
| recipient | string | recipients |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
# Open ( open )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: ”open” |
| message | string | message content |
| apiUser | string | API_USER |
| category | string | API_USER |
| maillistTaskId | long | task ID will be generated when you send emails with address list |
| mail_list_task_id | long | task ID will be generated when you send emails with address list |
| emailId | string | unique ID of each email |
| recipient | string | recipients |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| ip | string | opened IP address |
| explorerName | string | browser name |
| explorerVer | string | browser version |
| oSName | string | OS name |
| oSVer | string | OS version |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
# Click ( click )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: “type” |
| message | string | message content |
| apiUser | string | API_USER |
| category | string | API_USER |
| maillistTaskId | long | task ID will be generated when you send emails with address list |
| mail_list_task_id | long | task ID will be generated when you send emails with address list |
| emailId | string | unique ID of each email |
| recipient | string | recipients |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| url | string | clicked links |
| ip | string | clicked IP addresses |
| explorerName | string | browser name |
| explorerVer | string | browser version |
| oSName | string | OS name |
| oSVer | string | OS version |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
# Unsubscribe ( unsubscribe )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: ”unsubscribe” |
| message | string | message content |
| apiUser | string | API_USER |
| category | string | API_USER |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| maillistTaskId | long | task ID will be generated when you send emails with address list |
| mail_list_task_id | long | task ID will be generated when you send emails with address list |
| emailId | string | unique ID of each email |
| recipient | string | recipients |
| ip | string | IP address |
| explorerName | string | explorer name |
| explorerVer | string | explorer version |
| oSName | string | OS name |
| oSVer | string | OS version |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
# Spam Reporting ( report_spam )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: ” report_spam” |
| message | string | message content |
| apiUser | string | API_USER |
| category | string | API_USER |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| emailId | string | unique ID of each email |
| recipient | string | recipients |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
# Invalid Email ( invalid )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: ”invalid” |
| message | string | message content |
| apiUser | string | API_USER |
| category | string | API_USER |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| maillistTaskId | long | task ID will be generated when you send emails with address list |
| mail_list_task_id | long | task ID will be generated when you send emails with address list |
| emailId | string | unique ID of each email |
| outIp | string | outbound IP address |
| recipient | string | recipients |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
| substatdesc | string | invalid subclass description |
| substat | integer | invalid subclass |
Substat's return code and description：
|subStat|subStatDesc| |401 | in SendCloud blacklist| |402 | unsubscribe| |403 | server unreachable| |404 | address format error| |405 IP and domain rejected| |406 | address does not exist| |407 | spam| |408 | sender / recipient rejected| |409 | others|
# Soft Bounce ( soft_bounce )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: ” soft_bounce” |
| apiUser | string | API_USER |
| category | string | API_USER |
| labelId | int | custom label ID |
| labelName | string | custom label name |
| maillistTaskId | long | task ID will be generated when you send emails with address list |
| mail_list_task_id | long | task ID will be generated when you send emails with address list |
| emailId | string | unique ID of each email |
| outIp | string | outbound IP address |
| recipient | string | recipients |
| timestamp | long | timestamp |
| token | string | random string of 50 characters |
| signature | string | signature string |
| userHeaders | string | custom header with start of “SC-Custom” |
| substatdesc | string | soft drop back subclass description |
| substat | integer | soft drop back subclass |
| cause | string | reasons for soft credit withdrawal |
Substat's return code and description：
| subStat | subStatDesc |
|---|---|
| 503 | service not available |
| 505 | ip or domain rejected |
| 506 | email address does not exist |
| 507 | spam |
| 508 | sender / recipient rejected |
| 509 | others |
# Mail Routing ( route )
Parameter description
| parameter | type | description |
|---|---|---|
| event | string | event type: ” soft_bounce” |
| from | string | sender email address |
| fromname | string | sender name |
| headers | string | email headers, formatted with JSON |
| html | string | content in html format of routing email |
| message | string | message content “mx route” |
| raw_message_url | string | The download link of the route email, the suffix of the download file is '.eml', and the link is valid for 15 days |
| signature | string | signature string |
| subject | string | subject |
| text | string | content in text format of routing email |
| timestamp | long | timestamp |
| to | string | recipients address |
| token | string | random string of 50 characters |
| toname | string | recipient name |
| userHeaders | string | custom header with start of “SC-Custom” |
| reference | string | The associated field of reply message and its parent message, if any, consists of 'messageId' + 'number' + '@ sending domain name' |
| emailId | string | Unique ID of the parent message With this field, the reply message can be associated with the parent message. Whether this value has a value depends on whether the reply message of the receiving end has a reference header field |
Tips:
- If the reference has a value, the format is: the message ID (the part before the emailed $symbol) of the email sent by sendcloud and '@sending domain name'. eg："reference"："1644468027883_1024_25239_6195.sg-10_1_253_1-inbound0@ifaxin.com" #ifaxin.com为发信域名
- The prefix of emailId is the same as that of reference, prefixes are taken from messageId.
Java parsing EML file example,click here download
Post data example
maillistTaskId=-1&signature=eb6484eb14a429f7ea367647ffc9bc617ac8ce858afa2705d247f21177760ded&mail_list_task_id=-1&emailId=1576829271482_66557_24087_8851.sc-10_9_13_218-inbound0%24allsa%40sendcloud.cn&message=Successfully+delivered&apiUser=51eat_trigger&token=34szcNvC15W8wxLr1dONdBEuCfn4n4DpxHooDAkGMJf5pG2zVP&userHeaders=%7B%7D&labelId=0&recipient=allsa%40sendcloud.cn&event=deliver&category=51eat_trigger×tamp=1576829272783
1