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 CkPython Downloads
import sys
import chilkat
# Assumes Chilkat is unlocked. See Global Unlock Sample.
oauth = chilkat.CkOAuth2()
oauth.put_AuthorizationEndpoint("https://authz.constantcontact.com/oauth2/default/v1/authorize")
oauth.put_TokenEndpoint("https://authz.constantcontact.com/oauth2/default/v1/token")
oauth.put_ClientId("PKCE_CLIENT_ID")
oauth.put_LocalHost("localhost")
oauth.put_ListenPort(3017)
# Run authorization again if the account previously granted only contact access.
oauth.put_Scope("contact_data campaign_data offline_access")
oauth.put_CodeChallenge(True)
oauth.put_CodeChallengeMethod("S256")
oauth.put_UseBasicAuth(False)
url = oauth.startAuth()
if (oauth.get_LastMethodSuccess() != True):
print("Could not start the local listener. Check the registered port.")
sys.exit()
opened = oauth.LaunchBrowser(url)
if (opened != True):
oauth.Cancel()
print("Could not open the system browser.")
sys.exit()
waited = 0
while ((waited < 300000) and (oauth.get_AuthFlowState() < 3)) :
oauth.SleepMs(100)
waited = waited + 100
if (oauth.get_AuthFlowState() < 3):
oauth.Cancel()
print("Authorization timed out.")
sys.exit()
if (oauth.get_AuthFlowState() == 4):
print("Authorization was declined.")
sys.exit()
if (oauth.get_AuthFlowState() != 3):
print("Authorization failed. Check the PKCE app registration and exact redirect URI.")
sys.exit()
reply = chilkat.CkJsonObject()
parsed = reply.Load(oauth.accessTokenResponse())
if ((reply.JsonTypeOf("access_token") != 1) or (reply.IntOf("expires_in") <= 0)):
print("Token response is missing an access token or lifetime.")
sys.exit()
if (reply.StringOfEquals("access_token","",True) == True):
print("The returned access token is empty.")
sys.exit()
if ((reply.JsonTypeOf("refresh_token") != 1) or (reply.StringOfEquals("refresh_token","",True) == True)):
print("Missing refresh token. Check the offline_access scope and authorize again.")
sys.exit()
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()
tokens.UpdateString("client_id",oauth.clientId())
tokens.UpdateString("redirect_uri","http://localhost:3017/")
tokens.UpdateString("refresh_token",reply.stringOf("refresh_token"))
now = 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"))
saved = vault.UpdateSecretJson(entry,tokens)
if (saved != True):
print("Could not save the current token record. Check the credential store.")
sys.exit()
print("Authorization saved. Access-token lifetime in seconds: " + str(tokens.IntOf("expires_in")))