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

PowerShell
Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

$success = $false

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
$success = $false
$http = New-Object Chilkat.Http
$http.RequireSslCertVerify = $true
#  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
$http.AuthToken = "SENDGRID_API_KEY"
$resp = New-Object Chilkat.HttpResponse

#  Leave this empty to create a draft. To schedule, supply the ID of an already reviewed draft.
$reviewedDraftId = ""
if ($reviewedDraftId -eq "") {
    $draft = New-Object Chilkat.JsonObject
    $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 -ne $true) {
        if ($resp.StatusCode -eq 0) {
            $($http.LastErrorText)
        }
        else {
            $("HTTP " + $resp.StatusCode + ": " + $resp.BodyStr)
        }

        exit
    }

    if ($resp.StatusCode -ne 201) {
        $("HTTP " + $resp.StatusCode + ": " + $resp.BodyStr)
        exit
    }

    $created = New-Object Chilkat.JsonObject
    $success = $created.Load($resp.BodyStr)
    if ($success -ne $true) {
        $("Unexpected response: expected JSON.")
        exit
    }

    $draftId = $created.StringOf("id")
    if ($created.HasMember("id") -ne $true) {
        $("Missing id in response.")
        exit
    }

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

#  The example selects tomorrow at the current UTC time. Use your approved send time.
$releaseTime = New-Object Chilkat.CkDateTime
$releaseTime.SetFromCurrentSystemTime()
$releaseTime.AddDays(1)
$schedule = New-Object Chilkat.JsonObject
$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 -ne $true) {
    if ($resp.StatusCode -eq 0) {
        $($http.LastErrorText)
    }
    else {
        $("HTTP " + $resp.StatusCode + ": " + $resp.BodyStr)
    }

    exit
}

if ($resp.StatusCode -ne 201) {
    $("HTTP " + $resp.StatusCode + ": " + $resp.BodyStr)
    exit
}

$scheduled = New-Object Chilkat.JsonObject
$success = $scheduled.Load($resp.BodyStr)
if ($success -ne $true) {
    $("Unexpected response: expected JSON.")
    exit
}

$($scheduled.StringOf("status") + ": " + $scheduled.StringOf("send_at"))