Sample code for 30+ languages & platforms
C++ Requires Chilkat v11.0.0+

SendGrid: Schedule a reminder and cancel it by batch ID

See more SendGrid Examples

Schedule a reminder one hour from now. Save its batch ID when it is allocated. If the appointment is canceled, use that saved ID in the cancellation branch. Mail Send accepts a Unix timestamp up to 72 hours ahead; cancel at least 10 minutes before the send time. Cancellation applies to the entire batch.

Create a batch ID ยท Cancel a batch

Chilkat C++ Downloads

C++
#include <CkHttp.h>
#include <CkHttpResponse.h>
#include <CkJsonObject.h>
#include <CkDateTime.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false;
    CkHttp http;
    http.put_RequireSslCertVerify(true);
    //  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
    http.put_AuthToken("SENDGRID_API_KEY");
    CkHttpResponse resp;

    //  On cancellation, set this to the batch ID saved with the original appointment.
    //  This branch does not create a new batch or send another reminder.
    const char *batchToCancel = "";
    if (batchToCancel != "") {
        CkJsonObject cancellation;
        cancellation.UpdateString("batch_id",batchToCancel);
        cancellation.UpdateString("status","cancel");
        success = http.HttpJson("POST","https://api.sendgrid.com/v3/user/scheduled_sends",cancellation,"application/json",resp);
        if (success != true) {
            if (resp.get_StatusCode() == 0) {
                std::cout << http.lastErrorText() << "\r\n";
            }
            else {
                std::cout << "HTTP " << resp.get_StatusCode() << ": " << resp.bodyStr() << "\r\n";
            }

            return;
        }

        if (resp.get_StatusCode() != 201) {
            std::cout << "HTTP " << resp.get_StatusCode() << ": " << resp.bodyStr() << "\r\n";
            return;
        }

        std::cout << "Batch cancellation accepted." << "\r\n";
        return;
    }

    success = http.HttpNoBody("POST","https://api.sendgrid.com/v3/mail/batch",resp);
    if (success != true) {
        if (resp.get_StatusCode() == 0) {
            std::cout << http.lastErrorText() << "\r\n";
        }
        else {
            std::cout << "HTTP " << resp.get_StatusCode() << ": " << resp.bodyStr() << "\r\n";
        }

        return;
    }

    if (resp.get_StatusCode() != 201) {
        std::cout << "HTTP " << resp.get_StatusCode() << ": " << resp.bodyStr() << "\r\n";
        return;
    }

    CkJsonObject batch;
    success = batch.Load(resp.bodyStr());
    if (success != true) {
        std::cout << "Unexpected response: expected JSON." << "\r\n";
        return;
    }

    const char *batchId = batch.stringOf("batch_id");
    if (batch.HasMember("batch_id") != true) {
        std::cout << "Missing batch_id in response." << "\r\n";
        return;
    }

    //  Allocate one batch per independently cancelable appointment.
    std::cout << "Save this batch ID with the appointment: " << batchId << "\r\n";
    CkDateTime sendTime;
    sendTime.SetFromCurrentSystemTime();
    sendTime.AddSeconds(3600);
    CkJsonObject message;
    message.UpdateString("batch_id",batchId);
    message.UpdateInt("send_at",sendTime.GetAsUnixTime(false));
    message.UpdateString("from.email","sender@example.com");
    message.UpdateString("personalizations[0].to[0].email","recipient@example.com");
    message.UpdateString("subject","Appointment reminder");
    message.UpdateString("content[0].type","text/plain");
    message.UpdateString("content[0].value","Your appointment is tomorrow at 9:30 AM Central.");

    success = http.HttpJson("POST","https://api.sendgrid.com/v3/mail/send",message,"application/json",resp);
    if (success != true) {
        if (resp.get_StatusCode() == 0) {
            std::cout << http.lastErrorText() << "\r\n";
        }
        else {
            std::cout << "HTTP " << resp.get_StatusCode() << ": " << resp.bodyStr() << "\r\n";
        }

        return;
    }

    if (resp.get_StatusCode() != 202) {
        std::cout << "HTTP " << resp.get_StatusCode() << ": " << resp.bodyStr() << "\r\n";
        return;
    }

    std::cout << "Reminder scheduled for " << sendTime.getAsTimestamp(false) << "\r\n";
    }