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

.NET Core C#
//  Assumes Chilkat is unlocked. See Global Unlock Sample.
Chilkat.OAuth2 oauth = 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;
string url = oauth.StartAuth();
if (oauth.LastMethodSuccess != true) {
    Debug.WriteLine("Could not start the local listener. Check the registered port.");
    return;
}

bool opened = oauth.LaunchBrowser(url);
if (opened != true) {
    oauth.Cancel();
    Debug.WriteLine("Could not open the system browser.");
    return;
}

int waited = 0;
while (((waited < 300000) && (oauth.AuthFlowState < 3))) {
    oauth.SleepMs(100);
    waited = waited + 100;
}

if (oauth.AuthFlowState < 3) {
    oauth.Cancel();
    Debug.WriteLine("Authorization timed out.");
    return;
}

if (oauth.AuthFlowState == 4) {
    Debug.WriteLine("Authorization was declined.");
    return;
}

if (oauth.AuthFlowState != 3) {
    Debug.WriteLine("Authorization failed. Check the PKCE app registration and exact redirect URI.");
    return;
}

Chilkat.JsonObject reply = new Chilkat.JsonObject();
bool parsed = reply.Load(oauth.AccessTokenResponse);
if ((reply.JsonTypeOf("access_token") != 1) || (reply.IntOf("expires_in") <= 0)) {
    Debug.WriteLine("Token response is missing an access token or lifetime.");
    return;
}

if (reply.StringOfEquals("access_token","",true) == true) {
    Debug.WriteLine("The returned access token is empty.");
    return;
}

if ((reply.JsonTypeOf("refresh_token") != 1) || (reply.StringOfEquals("refresh_token","",true) == true)) {
    Debug.WriteLine("Missing refresh token. Check the offline_access scope and authorize again.");
    return;
}

Chilkat.Secrets vault = new Chilkat.Secrets();
vault.Location = "local_manager";
vault.AutoSplit = true;
Chilkat.JsonObject entry = new Chilkat.JsonObject();
entry.UpdateString("appName","ConstantContactV3");
entry.UpdateString("service","OAuth2");
entry.UpdateString("username","my-account");
Chilkat.JsonObject tokens = new Chilkat.JsonObject();
tokens.UpdateString("client_id",oauth.ClientId);
tokens.UpdateString("redirect_uri","http://localhost:3017/");
tokens.UpdateString("refresh_token",reply.StringOf("refresh_token"));
Chilkat.CkDateTime now = 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"));
bool saved = vault.UpdateSecretJson(entry,tokens);
if (saved != true) {
    Debug.WriteLine("Could not save the current token record. Check the credential store.");
    return;
}

Debug.WriteLine("Authorization saved. Access-token lifetime in seconds: " + Convert.ToString(tokens.IntOf("expires_in")));