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

SendGrid: Add or update list contacts and check the import job

See more SendGrid Examples

Use a Marketing Campaigns API key with contact access and the ID of an existing list. A 202 response queues the upsert; it does not confirm that the contacts were saved. Save the job ID and use it to recheck a pending import without submitting the contacts again. The error report may contain contact data; handle it privately.

Add or update contacts ยท Import job status

Chilkat Unicode C Downloads

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkHttpResponseW resp;
    const wchar_t *jobId;
    HCkJsonObjectW contacts;
    HCkJsonObjectW queued;
    HCkJsonObjectW job;
    const wchar_t *state;

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

    jobId = L"";
    if (jobId == L"") {
        contacts = CkJsonObjectW_Create();
        CkJsonObjectW_UpdateString(contacts,L"list_ids[0]",L"YOUR_LIST_UUID");
        CkJsonObjectW_UpdateString(contacts,L"contacts[0].email",L"avery@example.com");
        CkJsonObjectW_UpdateString(contacts,L"contacts[0].first_name",L"Avery");
        CkJsonObjectW_UpdateString(contacts,L"contacts[1].email",L"robin@example.com");
        CkJsonObjectW_UpdateString(contacts,L"contacts[1].first_name",L"Robin");
        success = CkHttpW_HttpJson(http,L"PUT",L"https://api.sendgrid.com/v3/marketing/contacts",contacts,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(contacts);
            return;
        }

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

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

        if (CkJsonObjectW_HasMember(queued,L"job_id") != TRUE) {
            wprintf(L"No job ID returned.\n");
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(contacts);
            CkJsonObjectW_Dispose(queued);
            return;
        }

        jobId = CkJsonObjectW_stringOf(queued,L"job_id");
        wprintf(L"Save this import job ID: %s\n",jobId);
    }

    CkHttpW_SetUrlVar(http,L"job",jobId);

    success = CkHttpW_HttpNoBody(http,L"GET",L"https://api.sendgrid.com/v3/marketing/contacts/imports/{$job}",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(contacts);
        CkJsonObjectW_Dispose(queued);
        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(contacts);
        CkJsonObjectW_Dispose(queued);
        return;
    }

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

    state = CkJsonObjectW_stringOf(job,L"status");
    if (state == L"pending") {
        wprintf(L"Still pending. Check again later with jobId = %s\n",jobId);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(contacts);
        CkJsonObjectW_Dispose(queued);
        CkJsonObjectW_Dispose(job);
        return;
    }

    wprintf(L"Job status: %s\n",state);
    wprintf(L"Created: %d, updated: %d, errors: %d\n",CkJsonObjectW_IntOf(job,L"results.created_count"),CkJsonObjectW_IntOf(job,L"results.updated_count"),CkJsonObjectW_IntOf(job,L"results.errored_count"));
    if ((state == L"errored") || (state == L"failed")) {
        wprintf(L"Review the job before retrying. If present, results.errors_url identifies the private error report.\n");
    }



    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(contacts);
    CkJsonObjectW_Dispose(queued);
    CkJsonObjectW_Dispose(job);

    }