Email

1. POST {BaseURL}/innomail/v1/messages/send
2. Content-Type: application/json; charset=utf-8
3. AppID: {APP_ID}
4. Nonce: {FRESH_RANDOM_NONCE}
5. CurTime: {UNIX_SECONDS}
6. CheckSum: {UPPERCASE_SHA1}
7. X-Idempotency-Key: {PERSISTED_BUSINESS_KEY}
8.  
9. {
10. "from": { "email": "notify@example.com" },
11. "to": [{ "email": "alice@example.net" }],
12. "subject": "Your order {{orderNo}} is confirmed",
13. "messageType": "TRANSACTIONAL",
14. "template": {
15. "templateId": "tpl_order_confirmation",
16. "variables": { "orderNo": "ORDER-001" }
17. }
18. }

1. POST {BaseURL}/innomail/v1/messages/batchsend
2. Content-Type: application/json; charset=utf-8
3. AppID: {APP_ID}
4. Nonce: {FRESH_RANDOM_NONCE}
5. CurTime: {UNIX_SECONDS}
6. CheckSum: {UPPERCASE_SHA1}
7. X-Idempotency-Key: {PERSISTED_BATCH_KEY}
8.  
9. {
10. "messages": [
11. {
12. "from": { "email": "news@example.com" },
13. "to": [{ "email": "alice@example.net" }],
14. "subject": "Product update",
15. "html": "<p>Hello Alice</p>",
16. "messageType": "MARKETING"
17. },
18. {
19. "from": { "email": "news@example.com" },
20. "to": [{ "email": "bob@example.net" }],
21. "subject": "Product update",
22. "html": "<p>Hello Bob</p>",
23. "messageType": "MARKETING"
24. }
25. ]
26. }

1. HTTP 200
2. {
3. "code": "000000",
4. "message": "success",
5. "data": {
6. "messageId": "SINGLE-01K59N7V000000000000000001",
7. "status": "ACCEPTED",
8. "acceptedAt": "2026-09-16T08:00:00Z"
9. },
10. "traceId": "REQ-1891234567890123456"
11. }
12.  
13. // ACCEPTED means the request was accepted.
14. // Check send records or enabled status notifications
15. // for the eventual delivery outcome.

CheckSum = UPPER_HEX(SHA1_UTF8(AppSecret + Nonce + CurTime))