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

CkPython
import sys
import chilkat

success = False

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
vault = chilkat.CkSecrets()
vault.put_Location("local_manager")
vault.put_AutoSplit(True)
entry = chilkat.CkJsonObject()
entry.UpdateString("appName","ConstantContactV3")
entry.UpdateString("service","OAuth2")
entry.UpdateString("username","my-account")
tokens = chilkat.CkJsonObject()
loaded = vault.GetSecretJson(entry,tokens)
if (loaded != True):
    print("Run the desktop authorization example using this account and store.")
    sys.exit()

if (tokens.JsonTypeOf("access_token") != 1):
    print("The saved authorization has no access token.")
    sys.exit()

http = chilkat.CkHttp()
http.put_RequireSslCertVerify(True)
http.put_AuthToken(tokens.stringOf("access_token"))
resp = chilkat.CkHttpResponse()

#  Use the full display name. AddParam encodes spaces and punctuation.
listName = "Workshop announcements"
query = chilkat.CkHttpRequest()
query.put_HttpVerb("GET")
query.AddParam("name",listName)
query.AddParam("status","active")
query.AddParam("include_membership_count","active")
success = http.HttpReq("https://api.cc.email/v3/contact_lists",query,resp)
if ((success != True) and (resp.get_StatusCode() <= 0)):
    print("Look up list: HTTP request failed.")
    sys.exit()

if ((success != True) or (resp.get_StatusCode() != 200)):
    print("Look up list: HTTP " + str(resp.get_StatusCode()) + " " + resp.bodyStr())
    sys.exit()

matches = chilkat.CkJsonObject()
success = matches.Load(resp.bodyStr())
if (success != True):
    print("Expected a JSON object in the response.")
    sys.exit()

if (matches.SizeOfArray("lists") == 0):
    print("No active email list named " + listName)
    sys.exit()

if ((matches.SizeOfArray("lists") != 1) or (matches.StringOfEquals("lists[0].name",listName,True) != True)):
    print("Expected one exact list name.")
    sys.exit()

listId = matches.stringOf("lists[0].list_id")
if (listId == ""):
    print("Missing list ID.")
    sys.exit()

print(listName + " | List ID: " + listId + " | Mailable contacts: " + str(matches.IntOf("lists[0].membership_count")))