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

VB.NET
Dim success As Boolean = False

'  Assumes Chilkat is unlocked. See Global Unlock Sample.
Dim vault As New Chilkat.Secrets
vault.Location = "local_manager"
vault.AutoSplit = True
Dim entry As New Chilkat.JsonObject
entry.UpdateString("appName","ConstantContactV3")
entry.UpdateString("service","OAuth2")
entry.UpdateString("username","my-account")
Dim tokens As New Chilkat.JsonObject
Dim loaded As Boolean = vault.GetSecretJson(entry,tokens)
If (loaded <> True) Then
    Debug.WriteLine("Run the desktop authorization example using this account and store.")
    Exit Sub
End If

If (tokens.JsonTypeOf("access_token") <> 1) Then
    Debug.WriteLine("The saved authorization has no access token.")
    Exit Sub
End If

Dim http As New Chilkat.Http
http.RequireSslCertVerify = True
http.AuthToken = tokens.StringOf("access_token")
Dim resp As New Chilkat.HttpResponse

'  Use the full display name. AddParam encodes spaces and punctuation.
Dim listName As String = "Workshop announcements"
Dim query As New Chilkat.HttpRequest
query.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.StatusCode <= 0)) Then
    Debug.WriteLine("Look up list: HTTP request failed.")
    Exit Sub
End If

If ((success <> True) Or (resp.StatusCode <> 200)) Then
    Debug.WriteLine("Look up list: HTTP " & resp.StatusCode & " " & resp.BodyStr)
    Exit Sub
End If

Dim matches As New Chilkat.JsonObject
success = matches.Load(resp.BodyStr)
If (success <> True) Then
    Debug.WriteLine("Expected a JSON object in the response.")
    Exit Sub
End If

If (matches.SizeOfArray("lists") = 0) Then
    Debug.WriteLine("No active email list named " & listName)
    Exit Sub
End If

If ((matches.SizeOfArray("lists") <> 1) Or (matches.StringOfEquals("lists[0].name",listName,True) <> True)) Then
    Debug.WriteLine("Expected one exact list name.")
    Exit Sub
End If

Dim listId As String = matches.StringOf("lists[0].list_id")
If (listId = "") Then
    Debug.WriteLine("Missing list ID.")
    Exit Sub
End If

Debug.WriteLine(listName & " | List ID: " & listId & " | Mailable contacts: " & matches.IntOf("lists[0].membership_count"))