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

Unicode C
#include <C_CkHttpW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkDateTimeW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkHttpResponseW resp;
    const wchar_t *reviewedDraftId;
    HCkJsonObjectW draft;
    HCkJsonObjectW created;
    const wchar_t *draftId;
    HCkDateTimeW releaseTime;
    HCkJsonObjectW schedule;
    HCkJsonObjectW scheduled;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = FALSE;
    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    //  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
    CkHttpW_putAuthToken(http,L"SENDGRID_API_KEY");
    resp = CkHttpResponseW_Create();

    //  Leave this empty to create a draft. To schedule, supply the ID of an already reviewed draft.
    reviewedDraftId = L"";
    if (reviewedDraftId == L"") {
        draft = CkJsonObjectW_Create();
        CkJsonObjectW_UpdateString(draft,L"name",L"November newsletter");
        CkJsonObjectW_UpdateString(draft,L"send_to.list_ids[0]",L"YOUR_LIST_UUID");
        CkJsonObjectW_UpdateInt(draft,L"email_config.sender_id",12345);
        CkJsonObjectW_UpdateInt(draft,L"email_config.suppression_group_id",67890);
        CkJsonObjectW_UpdateString(draft,L"email_config.design_id",L"YOUR_NEWSLETTER_DESIGN_UUID");
        success = CkHttpW_HttpJson(http,L"POST",L"https://api.sendgrid.com/v3/marketing/singlesends",draft,L"application/json",resp);
        if (success != TRUE) {
            if (CkHttpResponseW_getStatusCode(resp) == 0) {
                wprintf(L"%s\n",CkHttpW_lastErrorText(http));
            }
            else {
                wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
            }

            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(draft);
            return;
        }

        if (CkHttpResponseW_getStatusCode(resp) != 201) {
            wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(draft);
            return;
        }

        created = CkJsonObjectW_Create();
        success = CkJsonObjectW_Load(created,CkHttpResponseW_bodyStr(resp));
        if (success != TRUE) {
            wprintf(L"Unexpected response: expected JSON.\n");
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(draft);
            CkJsonObjectW_Dispose(created);
            return;
        }

        draftId = CkJsonObjectW_stringOf(created,L"id");
        if (CkJsonObjectW_HasMember(created,L"id") != TRUE) {
            wprintf(L"Missing id in response.\n");
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(draft);
            CkJsonObjectW_Dispose(created);
            return;
        }

        wprintf(L"Draft created: %s. Review it in Marketing Campaigns before scheduling.\n",draftId);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(draft);
        CkJsonObjectW_Dispose(created);
        return;
    }

    //  The example selects tomorrow at the current UTC time. Use your approved send time.
    releaseTime = CkDateTimeW_Create();
    CkDateTimeW_SetFromCurrentSystemTime(releaseTime);
    CkDateTimeW_AddDays(releaseTime,1);
    schedule = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(schedule,L"send_at",CkDateTimeW_getAsTimestamp(releaseTime,FALSE));
    CkHttpW_SetUrlVar(http,L"draft",reviewedDraftId);

    success = CkHttpW_HttpJson(http,L"PUT",L"https://api.sendgrid.com/v3/marketing/singlesends/{$draft}/schedule",schedule,L"application/json",resp);
    if (success != TRUE) {
        if (CkHttpResponseW_getStatusCode(resp) == 0) {
            wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        }
        else {
            wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
        }

        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(draft);
        CkJsonObjectW_Dispose(created);
        CkDateTimeW_Dispose(releaseTime);
        CkJsonObjectW_Dispose(schedule);
        return;
    }

    if (CkHttpResponseW_getStatusCode(resp) != 201) {
        wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(draft);
        CkJsonObjectW_Dispose(created);
        CkDateTimeW_Dispose(releaseTime);
        CkJsonObjectW_Dispose(schedule);
        return;
    }

    scheduled = CkJsonObjectW_Create();
    success = CkJsonObjectW_Load(scheduled,CkHttpResponseW_bodyStr(resp));
    if (success != TRUE) {
        wprintf(L"Unexpected response: expected JSON.\n");
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(draft);
        CkJsonObjectW_Dispose(created);
        CkDateTimeW_Dispose(releaseTime);
        CkJsonObjectW_Dispose(schedule);
        CkJsonObjectW_Dispose(scheduled);
        return;
    }

    wprintf(L"%s: %s\n",CkJsonObjectW_stringOf(scheduled,L"status"),CkJsonObjectW_stringOf(scheduled,L"send_at"));


    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(draft);
    CkJsonObjectW_Dispose(created);
    CkDateTimeW_Dispose(releaseTime);
    CkJsonObjectW_Dispose(schedule);
    CkJsonObjectW_Dispose(scheduled);

    }