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

SendGrid: Create a newsletter draft, then schedule the reviewed draft

See more SendGrid Examples

Prepare a Marketing Campaigns design with a subject, content, and an unsubscribe module. Supply the design and list UUIDs, a verified marketing sender ID, and the unsubscribe group ID. The first run creates only a draft. After reviewing the audience and content, run the scheduling branch with that same ID. Single Sends use an ISO 8601 UTC string, unlike Mail Send’s numeric Unix timestamp.

Create a Single Send · Schedule a Single Send

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

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

//  Leave this empty to create a draft. To schedule, supply the ID of an already reviewed draft.
var reviewedDraftId = "";
if (reviewedDraftId == "") {
    var draft = new CkJsonObject();
    draft.UpdateString("name","November newsletter");
    draft.UpdateString("send_to.list_ids[0]","YOUR_LIST_UUID");
    draft.UpdateInt("email_config.sender_id",12345);
    draft.UpdateInt("email_config.suppression_group_id",67890);
    draft.UpdateString("email_config.design_id","YOUR_NEWSLETTER_DESIGN_UUID");
    success = http.HttpJson("POST","https://api.sendgrid.com/v3/marketing/singlesends",draft,"application/json",resp);
    if (success !== true) {
        if (resp.StatusCode == 0) {
            console.log(http.LastErrorText);
        }
        else {
            console.log("HTTP " + resp.StatusCode + ": " + resp.BodyStr);
        }

        return;
    }

    if (resp.StatusCode !== 201) {
        console.log("HTTP " + resp.StatusCode + ": " + resp.BodyStr);
        return;
    }

    var created = new CkJsonObject();
    success = created.Load(resp.BodyStr);
    if (success !== true) {
        console.log("Unexpected response: expected JSON.");
        return;
    }

    var draftId = created.StringOf("id");
    if (created.HasMember("id") !== true) {
        console.log("Missing id in response.");
        return;
    }

    console.log("Draft created: " + draftId + ". Review it in Marketing Campaigns before scheduling.");
    return;
}

//  The example selects tomorrow at the current UTC time. Use your approved send time.
var releaseTime = new CkDateTime();
releaseTime.SetFromCurrentSystemTime();
releaseTime.AddDays(1);
var schedule = new CkJsonObject();
schedule.UpdateString("send_at",releaseTime.GetAsTimestamp(false));
http.SetUrlVar("draft",reviewedDraftId);

success = http.HttpJson("PUT","https://api.sendgrid.com/v3/marketing/singlesends/{$draft}/schedule",schedule,"application/json",resp);
if (success !== true) {
    if (resp.StatusCode == 0) {
        console.log(http.LastErrorText);
    }
    else {
        console.log("HTTP " + resp.StatusCode + ": " + resp.BodyStr);
    }

    return;
}

if (resp.StatusCode !== 201) {
    console.log("HTTP " + resp.StatusCode + ": " + resp.BodyStr);
    return;
}

var scheduled = new CkJsonObject();
success = scheduled.Load(resp.BodyStr);
if (success !== true) {
    console.log("Unexpected response: expected JSON.");
    return;
}

console.log(scheduled.StringOf("status") + ": " + scheduled.StringOf("send_at"));