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

PHP ActiveX
<?php

$success = 0;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
$success = 0;
$http = new COM("Chilkat.Http");
$http->RequireSslCertVerify = 1;
//  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
$http->AuthToken = 'SENDGRID_API_KEY';
$resp = new COM("Chilkat.HttpResponse");

//  Leave this empty to create a draft. To schedule, supply the ID of an already reviewed draft.
$reviewedDraftId = '';
if ($reviewedDraftId == '') {
    $draft = new COM("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 != 1) {
        if ($resp->StatusCode == 0) {
            print $http->LastErrorText . "\n";
        }
        else {
            print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
        }

        exit;
    }

    if ($resp->StatusCode != 201) {
        print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
        exit;
    }

    $created = new COM("Chilkat.JsonObject");
    $success = $created->Load($resp->BodyStr);
    if ($success != 1) {
        print 'Unexpected response: expected JSON.' . "\n";
        exit;
    }

    $draftId = $created->stringOf('id');
    if ($created->HasMember('id') != 1) {
        print 'Missing id in response.' . "\n";
        exit;
    }

    print 'Draft created: ' . $draftId . '. Review it in Marketing Campaigns before scheduling.' . "\n";
    exit;
}

//  The example selects tomorrow at the current UTC time. Use your approved send time.
$releaseTime = new COM("Chilkat.CkDateTime");
$releaseTime->SetFromCurrentSystemTime();
$releaseTime->AddDays(1);
$schedule = new COM("Chilkat.JsonObject");
$schedule->UpdateString('send_at',$releaseTime->getAsTimestamp(0));
$http->SetUrlVar('draft',$reviewedDraftId);

$success = $http->HttpJson('PUT','https://api.sendgrid.com/v3/marketing/singlesends/{$draft}/schedule',$schedule,'application/json',$resp);
if ($success != 1) {
    if ($resp->StatusCode == 0) {
        print $http->LastErrorText . "\n";
    }
    else {
        print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    }

    exit;
}

if ($resp->StatusCode != 201) {
    print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    exit;
}

$scheduled = new COM("Chilkat.JsonObject");
$success = $scheduled->Load($resp->BodyStr);
if ($success != 1) {
    print 'Unexpected response: expected JSON.' . "\n";
    exit;
}

print $scheduled->stringOf('status') . ': ' . $scheduled->stringOf('send_at') . "\n";

?>