Sample code for 30+ languages & platforms
Delphi ActiveX 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 Delphi ActiveX Downloads

Delphi ActiveX
var
oauth: TChilkatOAuth2;
url: WideString;
opened: Integer;
waited: Integer;
reply: TChilkatJsonObject;
parsed: Integer;
vault: TChilkatSecrets;
entry: TChilkatJsonObject;
tokens: TChilkatJsonObject;
now: TCkDateTime;
saved: Integer;

begin
//  Assumes Chilkat is unlocked. See Global Unlock Sample.
oauth := TChilkatOAuth2.Create(Self);
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 := 1;
oauth.CodeChallengeMethod := 'S256';
oauth.UseBasicAuth := 0;
url := oauth.StartAuth();
if (oauth.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add('Could not start the local listener. Check the registered port.');
    Exit;
  end;
opened := oauth.LaunchBrowser(url);
if (opened <> 1) then
  begin
    oauth.Cancel();
    Memo1.Lines.Add('Could not open the system browser.');
    Exit;
  end;
waited := 0;
while ((waited < 300000) and (oauth.AuthFlowState < 3)) do
  begin
    oauth.SleepMs(100);
    waited := waited + 100;
  end;

if (oauth.AuthFlowState < 3) then
  begin
    oauth.Cancel();
    Memo1.Lines.Add('Authorization timed out.');
    Exit;
  end;
if (oauth.AuthFlowState = 4) then
  begin
    Memo1.Lines.Add('Authorization was declined.');
    Exit;
  end;
if (oauth.AuthFlowState <> 3) then
  begin
    Memo1.Lines.Add('Authorization failed. Check the PKCE app registration and exact redirect URI.');
    Exit;
  end;
reply := TChilkatJsonObject.Create(Self);
parsed := reply.Load(oauth.AccessTokenResponse);
if ((reply.JsonTypeOf('access_token') <> 1) or (reply.IntOf('expires_in') <= 0)) then
  begin
    Memo1.Lines.Add('Token response is missing an access token or lifetime.');
    Exit;
  end;
if (reply.StringOfEquals('access_token','',1) = 1) then
  begin
    Memo1.Lines.Add('The returned access token is empty.');
    Exit;
  end;
if ((reply.JsonTypeOf('refresh_token') <> 1) or (reply.StringOfEquals('refresh_token','',1) = 1)) then
  begin
    Memo1.Lines.Add('Missing refresh token. Check the offline_access scope and authorize again.');
    Exit;
  end;
vault := TChilkatSecrets.Create(Self);
vault.Location := 'local_manager';
vault.AutoSplit := 1;
entry := TChilkatJsonObject.Create(Self);
entry.UpdateString('appName','ConstantContactV3');
entry.UpdateString('service','OAuth2');
entry.UpdateString('username','my-account');
tokens := TChilkatJsonObject.Create(Self);
tokens.UpdateString('client_id',oauth.ClientId);
tokens.UpdateString('redirect_uri','http://localhost:3017/');
tokens.UpdateString('refresh_token',reply.StringOf('refresh_token'));
now := TCkDateTime.Create(Self);
now.SetFromCurrentSystemTime();
tokens.UpdateString('obtained_at_utc',now.GetAsTimestamp(0));
tokens.UpdateString('access_token',reply.StringOf('access_token'));
tokens.UpdateInt('expires_in',reply.IntOf('expires_in'));
saved := vault.UpdateSecretJson(entry.ControlInterface,tokens.ControlInterface);
if (saved <> 1) then
  begin
    Memo1.Lines.Add('Could not save the current token record. Check the credential store.');
    Exit;
  end;
Memo1.Lines.Add('Authorization saved. Access-token lifetime in seconds: ' + IntToStr(tokens.IntOf('expires_in')));