Our eDM delivery service offers HTTP POST method for sending email messages.Upon receiving a send request through our X Lead platform, we promptly issue a reference id. This immediate feedback serves as an acknowledgment to your system, confirming that we have successfully received the request and queued it for processing.After processing, we will provide the status of your request through your callback URL. The response may indicate a valid send with the corresponding number of quota to deduct, or it may be an invalid submission due to reasons such as insufficient quota, an invalid email address, or the email being in the unsend list.Once the message has been submitted to our email gateay, our service extends an additional callback feature. This focuses on the response from the recipient's email serverhandheld device. Once the telecommunications operator receives a delivery status from the recipient's device, we relay this information back to you through your callback URL, and this is crucial for understanding the success rate of your sent messages and for troubleshooting any issues related to message delivery.Our system is designed to keep you thoroughly informed throughout the entire process. From the moment your message is dispatched from our platform, we ensure that each step is communicated back to you for effective tracking.Here is the complete flow of the delivery and report operation.
Callback is the URL you provided to us in order to listen to our updates in below format :| Field | Description |
|---|
| rc | return code |
| rm | return message with detail explanation, if any |
| ref_id | reference id that we returned during your original API call |
| status | submission or delivery status of your API request |
Callback (Send Request Report)This is an update on the status of your send request, if it is processed as a valid request, you will receive a callback call with the message 'OK', indicating that it has been successfully validated and submitted to the carrier. In the event of a failure, you may encounter the following scenarios with corresponding status. Only messages with return code (rc = 100) are transmitted to carrier and will be charged.| Status | Description |
|---|
| SMD | A valid send, message has been put to gateway for delivery |
rc = -100 (message will not be charged)| Status | Description |
|---|
| IE | Incorrect email address |
| IUL | In unsend list, message did not send out |
| IP | Insufficient quota |
You must first log into your account dashboard and set up this Callback URL in order to receive our status update of messages delivery.
