Sample code for 30+ languages & platforms
Xbase++ 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

Chilkat Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL oHttp
LOCAL oResp
LOCAL cReviewedDraftId
LOCAL oDraft
LOCAL oCreated
LOCAL cDraftId
LOCAL oReleaseTime
LOCAL oSchedule
LOCAL oScheduled

nSuccess := 0

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
nSuccess := 0
oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
//  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
oHttp:AuthToken := "SENDGRID_API_KEY"
oResp := CreateObject("Chilkat.HttpResponse")

//  Leave this empty to create a draft. To schedule, supply the ID of an already reviewed draft.
cReviewedDraftId := ""
IF (cReviewedDraftId == "")
    oDraft := CreateObject("Chilkat.JsonObject")
    oDraft:UpdateString("name", "November newsletter")
    oDraft:UpdateString("send_to.list_ids[0]", "YOUR_LIST_UUID")
    oDraft:UpdateInt("email_config.sender_id", 12345)
    oDraft:UpdateInt("email_config.suppression_group_id", 67890)
    oDraft:UpdateString("email_config.design_id", "YOUR_NEWSLETTER_DESIGN_UUID")
    nSuccess := oHttp:HttpJson("POST", "https://api.sendgrid.com/v3/marketing/singlesends", oDraft, "application/json", oResp)
    IF (nSuccess != 1)
        IF (oResp:StatusCode == 0)
            ? oHttp:LastErrorText
        ELSE
            ? "HTTP " + Str(oResp:StatusCode) + ": " + oResp:BodyStr
        ENDIF

        oHttp:destroy()
        oResp:destroy()
        oDraft:destroy()
        RETURN
    ENDIF

    IF (oResp:StatusCode != 201)
        ? "HTTP " + Str(oResp:StatusCode) + ": " + oResp:BodyStr
        oHttp:destroy()
        oResp:destroy()
        oDraft:destroy()
        RETURN
    ENDIF

    oCreated := CreateObject("Chilkat.JsonObject")
    nSuccess := oCreated:Load(oResp:BodyStr)
    IF (nSuccess != 1)
        ? "Unexpected response: expected JSON."
        oHttp:destroy()
        oResp:destroy()
        oDraft:destroy()
        oCreated:destroy()
        RETURN
    ENDIF

    cDraftId := oCreated:StringOf("id")
    IF (oCreated:HasMember("id") != 1)
        ? "Missing id in response."
        oHttp:destroy()
        oResp:destroy()
        oDraft:destroy()
        oCreated:destroy()
        RETURN
    ENDIF

    ? "Draft created: " + cDraftId + ". Review it in Marketing Campaigns before scheduling."
    oHttp:destroy()
    oResp:destroy()
    oDraft:destroy()
    oCreated:destroy()
    RETURN
ENDIF

//  The example selects tomorrow at the current UTC time. Use your approved send time.
oReleaseTime := CreateObject("Chilkat.CkDateTime")
oReleaseTime:SetFromCurrentSystemTime()
oReleaseTime:AddDays(1)
oSchedule := CreateObject("Chilkat.JsonObject")
oSchedule:UpdateString("send_at", oReleaseTime:GetAsTimestamp(0))
oHttp:SetUrlVar("draft", cReviewedDraftId)

nSuccess := oHttp:HttpJson("PUT", "https://api.sendgrid.com/v3/marketing/singlesends/{$draft}/schedule", oSchedule, "application/json", oResp)
IF (nSuccess != 1)
    IF (oResp:StatusCode == 0)
        ? oHttp:LastErrorText
    ELSE
        ? "HTTP " + Str(oResp:StatusCode) + ": " + oResp:BodyStr
    ENDIF

    oHttp:destroy()
    oResp:destroy()
    oDraft:destroy()
    oCreated:destroy()
    oReleaseTime:destroy()
    oSchedule:destroy()
    RETURN
ENDIF

IF (oResp:StatusCode != 201)
    ? "HTTP " + Str(oResp:StatusCode) + ": " + oResp:BodyStr
    oHttp:destroy()
    oResp:destroy()
    oDraft:destroy()
    oCreated:destroy()
    oReleaseTime:destroy()
    oSchedule:destroy()
    RETURN
ENDIF

oScheduled := CreateObject("Chilkat.JsonObject")
nSuccess := oScheduled:Load(oResp:BodyStr)
IF (nSuccess != 1)
    ? "Unexpected response: expected JSON."
    oHttp:destroy()
    oResp:destroy()
    oDraft:destroy()
    oCreated:destroy()
    oReleaseTime:destroy()
    oSchedule:destroy()
    oScheduled:destroy()
    RETURN
ENDIF

? oScheduled:StringOf("status") + ": " + oScheduled:StringOf("send_at")

oHttp:destroy()
oResp:destroy()
oDraft:destroy()
oCreated:destroy()
oReleaseTime:destroy()
oSchedule:destroy()
oScheduled:destroy()