C++ Requires Chilkat v11.0.0+
C++
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
#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";
}