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
' 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"))