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

Constant Contact V3: Find a contact list by name

See more Constant Contact Examples

Start with the full list name from the Constant Contact account. Read its list_id and the number of active, mailable contacts. Use the ID for list membership operations or campaign targeting. This lookup requires contact_data.

Authorize the application using the same account and credential store.

Constant Contact developer guide

Chilkat Unicode C Downloads

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkSecretsW vault;
    HCkJsonObjectW entry;
    HCkJsonObjectW tokens;
    BOOL loaded;
    HCkHttpW http;
    HCkHttpResponseW resp;
    const wchar_t *listName;
    HCkHttpRequestW query;
    HCkJsonObjectW matches;
    const wchar_t *listId;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    vault = CkSecretsW_Create();
    CkSecretsW_putLocation(vault,L"local_manager");
    CkSecretsW_putAutoSplit(vault,TRUE);
    entry = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(entry,L"appName",L"ConstantContactV3");
    CkJsonObjectW_UpdateString(entry,L"service",L"OAuth2");
    CkJsonObjectW_UpdateString(entry,L"username",L"my-account");
    tokens = CkJsonObjectW_Create();
    loaded = CkSecretsW_GetSecretJson(vault,entry,tokens);
    if (loaded != TRUE) {
        wprintf(L"Run the desktop authorization example using this account and store.\n");
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        return;
    }

    if (CkJsonObjectW_JsonTypeOf(tokens,L"access_token") != 1) {
        wprintf(L"The saved authorization has no access token.\n");
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        return;
    }

    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    CkHttpW_putAuthToken(http,CkJsonObjectW_stringOf(tokens,L"access_token"));
    resp = CkHttpResponseW_Create();

    //  Use the full display name. AddParam encodes spaces and punctuation.
    listName = L"Workshop announcements";
    query = CkHttpRequestW_Create();
    CkHttpRequestW_putHttpVerb(query,L"GET");
    CkHttpRequestW_AddParam(query,L"name",listName);
    CkHttpRequestW_AddParam(query,L"status",L"active");
    CkHttpRequestW_AddParam(query,L"include_membership_count",L"active");
    success = CkHttpW_HttpReq(http,L"https://api.cc.email/v3/contact_lists",query,resp);
    if ((success != TRUE) && (CkHttpResponseW_getStatusCode(resp) <= 0)) {
        wprintf(L"Look up list: HTTP request failed.\n");
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkHttpRequestW_Dispose(query);
        return;
    }

    if ((success != TRUE) || (CkHttpResponseW_getStatusCode(resp) != 200)) {
        wprintf(L"Look up list: HTTP %d %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkHttpRequestW_Dispose(query);
        return;
    }

    matches = CkJsonObjectW_Create();
    success = CkJsonObjectW_Load(matches,CkHttpResponseW_bodyStr(resp));
    if (success != TRUE) {
        wprintf(L"Expected a JSON object in the response.\n");
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkHttpRequestW_Dispose(query);
        CkJsonObjectW_Dispose(matches);
        return;
    }

    if (CkJsonObjectW_SizeOfArray(matches,L"lists") == 0) {
        wprintf(L"No active email list named %s\n",listName);
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkHttpRequestW_Dispose(query);
        CkJsonObjectW_Dispose(matches);
        return;
    }

    if ((CkJsonObjectW_SizeOfArray(matches,L"lists") != 1) || (CkJsonObjectW_StringOfEquals(matches,L"lists[0].name",listName,TRUE) != TRUE)) {
        wprintf(L"Expected one exact list name.\n");
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkHttpRequestW_Dispose(query);
        CkJsonObjectW_Dispose(matches);
        return;
    }

    listId = CkJsonObjectW_stringOf(matches,L"lists[0].list_id");
    if (listId == L"") {
        wprintf(L"Missing list ID.\n");
        CkSecretsW_Dispose(vault);
        CkJsonObjectW_Dispose(entry);
        CkJsonObjectW_Dispose(tokens);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkHttpRequestW_Dispose(query);
        CkJsonObjectW_Dispose(matches);
        return;
    }

    wprintf(L"%s | List ID: %s | Mailable contacts: %d\n",listName,listId,CkJsonObjectW_IntOf(matches,L"lists[0].membership_count"));


    CkSecretsW_Dispose(vault);
    CkJsonObjectW_Dispose(entry);
    CkJsonObjectW_Dispose(tokens);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkHttpRequestW_Dispose(query);
    CkJsonObjectW_Dispose(matches);

    }