Request a Return Receipt for an Email

See more Email Object Examples

Demonstrates the Chilkat Email.ReturnReceipt property. Set it to true to request a return-receipt when the message is received; this causes a Disposition-Notification-To header to be added when the email is sent. The default is false. This example enables the request.

Background: A return receipt (technically a Message Disposition Notification, MDN) asks the recipient's mail client to send back a small confirmation when the message is opened. It is only a request: the receiving client or server is free to ignore it, and many prompt the user before sending anything. Because of this, a return receipt is not reliable proof that a human actually read the message — treat it as a courtesy signal, not a guarantee.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkEmail email;

    //  Demonstrates the Email.ReturnReceipt property.  Set to true to request a
    //  return-receipt when the email is received.  This causes a Disposition-Notification-To
    //  header to be added when the email is sent.  The default is false.

    email = CkEmail_Create();
    CkEmail_putSubject(email,"Please confirm receipt");
    CkEmail_putBody(email,"Kindly confirm you received this message.");
    CkEmail_putFrom(email,"alice@example.com");
    CkEmail_AddTo(email,"Bob","bob@example.com");

    //  Request a return receipt.
    CkEmail_putReturnReceipt(email,TRUE);

    printf("ReturnReceipt = %d\n",CkEmail_getReturnReceipt(email));


    CkEmail_Dispose(email);

    }