Sample code for 30+ languages & platforms
Unicode C Requires Chilkat v11.0.0+

SendGrid: Save and verify a topic opt-out

See more SendGrid Examples

Use this when a signed-in reader turns off Product updates. Look up the configured group before submitting: SendGrid warns that a nonexistent or deleted group can cause a global suppression instead. Keep the group active while processing preferences. Deleting a marketing contact is not a substitute for recording an opt-out.

Add group suppressions ยท Check specific addresses

Chilkat Unicode C Downloads

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkHttpResponseW resp;
    const wchar_t *address;
    HCkJsonObjectW groupInfo;
    HCkJsonObjectW addresses;
    HCkJsonArrayW matches;

    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();

    //  Take the address from the authenticated account and the group ID from configuration.
    address = L"reader@example.com";
    CkHttpW_SetUrlVar(http,L"group",L"12345");

    success = CkHttpW_HttpNoBody(http,L"GET",L"https://api.sendgrid.com/v3/asm/groups/{$group}",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);
        return;
    }

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

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

    if (CkJsonObjectW_StringOfEquals(groupInfo,L"name",L"Product updates",TRUE) != TRUE) {
        wprintf(L"Unexpected unsubscribe group; no preference was changed.\n");
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(groupInfo);
        return;
    }

    addresses = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(addresses,L"recipient_emails[0]",address);

    success = CkHttpW_HttpJson(http,L"POST",L"https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions",addresses,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(groupInfo);
        CkJsonObjectW_Dispose(addresses);
        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(groupInfo);
        CkJsonObjectW_Dispose(addresses);
        return;
    }

    success = CkHttpW_HttpJson(http,L"POST",L"https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions/search",addresses,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(groupInfo);
        CkJsonObjectW_Dispose(addresses);
        return;
    }

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

    matches = CkJsonArrayW_Create();
    success = CkJsonArrayW_Load(matches,CkHttpResponseW_bodyStr(resp));
    if (success != TRUE) {
        wprintf(L"Unexpected response: expected JSON.\n");
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(groupInfo);
        CkJsonObjectW_Dispose(addresses);
        CkJsonArrayW_Dispose(matches);
        return;
    }

    if (CkJsonArrayW_getSize(matches) == 1) {
        wprintf(L"Confirmed opt-out: %s\n",CkJsonArrayW_stringAt(matches,0));
    }
    else {
        wprintf(L"Opt-out not confirmed. Recheck this group.\n");
    }



    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(groupInfo);
    CkJsonObjectW_Dispose(addresses);
    CkJsonArrayW_Dispose(matches);

    }