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

CkPython
import sys
import chilkat

success = False

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

#  Leave this empty to create a draft. To schedule, supply the ID of an already reviewed draft.
reviewedDraftId = ""
if (reviewedDraftId == ""):
    draft = chilkat.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.get_StatusCode() == 0):
            print(http.lastErrorText())
        else:
            print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())

        sys.exit()

    if (resp.get_StatusCode() != 201):
        print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())
        sys.exit()

    created = chilkat.CkJsonObject()
    success = created.Load(resp.bodyStr())
    if (success != True):
        print("Unexpected response: expected JSON.")
        sys.exit()

    draftId = created.stringOf("id")
    if (created.HasMember("id") != True):
        print("Missing id in response.")
        sys.exit()

    print("Draft created: " + draftId + ". Review it in Marketing Campaigns before scheduling.")
    sys.exit()

#  The example selects tomorrow at the current UTC time. Use your approved send time.
releaseTime = chilkat.CkDateTime()
releaseTime.SetFromCurrentSystemTime()
releaseTime.AddDays(1)
schedule = chilkat.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.get_StatusCode() == 0):
        print(http.lastErrorText())
    else:
        print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())

    sys.exit()

if (resp.get_StatusCode() != 201):
    print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())
    sys.exit()

scheduled = chilkat.CkJsonObject()
success = scheduled.Load(resp.bodyStr())
if (success != True):
    print("Unexpected response: expected JSON.")
    sys.exit()

print(scheduled.stringOf("status") + ": " + scheduled.stringOf("send_at"))