Sample code for 30+ languages & platforms
VB.NET Requires Chilkat v11.0.0+

Constant Contact V3: Authorize a desktop app with PKCE

See more Constant Contact Examples

Register a V3 app for the public-client PKCE flow and register http://localhost:3017/ exactly, including the trailing slash. Chilkat opens the system browser, receives the redirect on the same computer, and exchanges the code using the PKCE verifier. Request contact_data for contacts and lists, campaign_data for email campaigns and reporting, and offline_access for refresh. If the app already has a contacts-only grant, repeat this browser authorization to grant campaign access. Refreshing the old token cannot add a scope. Use a client ID from the PKCE app registration.

The examples share a Chilkat Secrets record. Windows Credential Manager and Apple Keychain persist the local record. On systems where the local manager uses process memory, configure a persistent Secrets backend for all examples. Give each authorized account its own record name. If migrating from the old token-file example, authorize once to populate the store.

Constant Contact developer guide

Chilkat VB.NET Downloads

VB.NET
'  Assumes Chilkat is unlocked. See Global Unlock Sample.
Dim oauth As New Chilkat.OAuth2
oauth.AuthorizationEndpoint = "https://authz.constantcontact.com/oauth2/default/v1/authorize"
oauth.TokenEndpoint = "https://authz.constantcontact.com/oauth2/default/v1/token"
oauth.ClientId = "PKCE_CLIENT_ID"
oauth.LocalHost = "localhost"
oauth.ListenPort = 3017
'  Run authorization again if the account previously granted only contact access.
oauth.Scope = "contact_data campaign_data offline_access"
oauth.CodeChallenge = True
oauth.CodeChallengeMethod = "S256"
oauth.UseBasicAuth = False
Dim url As String = oauth.StartAuth()
If (oauth.LastMethodSuccess <> True) Then
    Debug.WriteLine("Could not start the local listener. Check the registered port.")
    Exit Sub
End If

Dim opened As Boolean = oauth.LaunchBrowser(url)
If (opened <> True) Then
    oauth.Cancel()
    Debug.WriteLine("Could not open the system browser.")
    Exit Sub
End If

Dim waited As Integer = 0
While ((waited < 300000) And (oauth.AuthFlowState < 3))
    oauth.SleepMs(100)
    waited = waited + 100
End While
If (oauth.AuthFlowState < 3) Then
    oauth.Cancel()
    Debug.WriteLine("Authorization timed out.")
    Exit Sub
End If

If (oauth.AuthFlowState = 4) Then
    Debug.WriteLine("Authorization was declined.")
    Exit Sub
End If

If (oauth.AuthFlowState <> 3) Then
    Debug.WriteLine("Authorization failed. Check the PKCE app registration and exact redirect URI.")
    Exit Sub
End If

Dim reply As New Chilkat.JsonObject
Dim parsed As Boolean = reply.Load(oauth.AccessTokenResponse)
If ((reply.JsonTypeOf("access_token") <> 1) Or (reply.IntOf("expires_in") <= 0)) Then
    Debug.WriteLine("Token response is missing an access token or lifetime.")
    Exit Sub
End If

If (reply.StringOfEquals("access_token","",True) = True) Then
    Debug.WriteLine("The returned access token is empty.")
    Exit Sub
End If

If ((reply.JsonTypeOf("refresh_token") <> 1) Or (reply.StringOfEquals("refresh_token","",True) = True)) Then
    Debug.WriteLine("Missing refresh token. Check the offline_access scope and authorize again.")
    Exit Sub
End If

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
tokens.UpdateString("client_id",oauth.ClientId)
tokens.UpdateString("redirect_uri","http://localhost:3017/")
tokens.UpdateString("refresh_token",reply.StringOf("refresh_token"))
Dim now As New Chilkat.CkDateTime
now.SetFromCurrentSystemTime()
tokens.UpdateString("obtained_at_utc",now.GetAsTimestamp(False))
tokens.UpdateString("access_token",reply.StringOf("access_token"))
tokens.UpdateInt("expires_in",reply.IntOf("expires_in"))
Dim saved As Boolean = vault.UpdateSecretJson(entry,tokens)
If (saved <> True) Then
    Debug.WriteLine("Could not save the current token record. Check the credential store.")
    Exit Sub
End If

Debug.WriteLine("Authorization saved. Access-token lifetime in seconds: " & tokens.IntOf("expires_in"))