Outlook Calendar: Refresh a Delegated Access Token
See more Outlook Calendar Examples
Refresh the Graph token obtained by the public desktop PKCE example, without a client secret or browser. Use the same client ID and authority. This works after a user has signed in and consented; it is not app-only authentication. A refresh token is not permanent: invalid_grant or an interaction requirement means the user must authorize again.
Form parameters are encoded by Chilkat. HTTP/JSON/token-validation failures leave the old cache untouched. Save a new refresh token when one is returned; retain the previous one if the field is absent. A private backup protects against a replacement-write failure; production code should replace credentials atomically, serialize refreshes per account, and remove obsolete protected backups according to its retention policy. No credentials are printed.
The cache is qa_data/tokens/outlookCalendar.json. Refresh before its acquired-time plus expires_in lifetime has elapsed. Keep each cache associated with its original app and account.
HTTP methods can return false for an HTTP error as well as a connection failure. The code distinguishes those cases and checks the expected status before reading JSON. For 401, refresh the access token or authorize again; for 403, check permissions, mailbox access, and tenant policy. For 429, honor Retry-After before a bounded retry. Do not automatically repeat a write after an uncertain outcome. Keep detailed errors and calendar data private.
Chilkat C# Downloads
bool success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success = false;
Chilkat.JsonObject token = new Chilkat.JsonObject();
token.Strict = true;
success = token.LoadFile("qa_data/tokens/outlookCalendar.json");
if (success != true) {
Debug.WriteLine("Read the private token cache or authorize again.");
return;
}
if ((token.JsonTypeOf("refresh_token") != 1) || (token.StringOfEquals("refresh_token","",true) == true)) {
Debug.WriteLine("Expected a nonempty refresh_token in the JSON.");
return;
}
string clientId = "YOUR_APPLICATION_CLIENT_ID";
// Use the same app and authority as the original authorization.
string tokenUrl = "https://login.microsoftonline.com/common/oauth2/v2.0/token";
Chilkat.Http http = new Chilkat.Http();
http.RequireSslCertVerify = true;
http.FollowRedirects = false;
http.ConnectTimeout = 20;
http.ReadTimeout = 30;
Chilkat.HttpRequest req = new Chilkat.HttpRequest();
req.HttpVerb = "POST";
req.ContentType = "application/x-www-form-urlencoded";
req.AddParam("client_id",clientId);
req.AddParam("grant_type","refresh_token");
req.AddParam("refresh_token",token.StringOf("refresh_token"));
// Omitting scope retains the original grant instead of requesting additional permissions.
Chilkat.HttpResponse resp = new Chilkat.HttpResponse();
Chilkat.JsonObject result = new Chilkat.JsonObject();
result.Strict = true;
success = http.HttpReq(tokenUrl,req,resp);
// A false result can still include an HTTP error response.
if ((success != true) && (resp.StatusCode == 0)) {
Debug.WriteLine("No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.");
return;
}
if (resp.StatusCode != 200) {
Debug.WriteLine("Unexpected HTTP status: " + Convert.ToString(resp.StatusCode));
Debug.WriteLine("Request ID: " + resp.GetHeaderField("request-id"));
if (resp.StatusCode == 429) {
Debug.WriteLine("Retry-After: " + resp.GetHeaderField("Retry-After"));
}
if (resp.StatusCode == 401) {
Debug.WriteLine("Refresh the Graph access token or authorize again.");
}
return;
}
success = result.Load(resp.BodyStr);
if (success != true) {
Debug.WriteLine("Expected a well-formed JSON response.");
return;
}
if ((result.JsonTypeOf("access_token") != 1) || (result.StringOfEquals("access_token","",true) == true)) {
Debug.WriteLine("Expected a nonempty access_token in the JSON.");
return;
}
if ((result.JsonTypeOf("expires_in") != 2) || (result.IntOf("expires_in") <= 0)) {
Debug.WriteLine("Missing token lifetime; old cache unchanged.");
return;
}
if (result.JsonTypeOf("refresh_token") == -1) {
result.UpdateString("refresh_token",token.StringOf("refresh_token"));
}
else {
if ((result.JsonTypeOf("refresh_token") != 1) || (result.StringOfEquals("refresh_token","",true) == true)) {
Debug.WriteLine("Expected a nonempty refresh_token in the JSON.");
return;
}
}
Chilkat.CkDateTime obtained = new Chilkat.CkDateTime();
success = obtained.SetFromCurrentSystemTime();
if (success != true) {
Debug.WriteLine("Could not timestamp the refreshed token.");
return;
}
result.UpdateString("obtained_at",obtained.GetAsTimestamp(false));
// Keep a valid previous cache for recovery if the replacement write fails.
success = token.WriteFile("qa_data/tokens/outlookCalendar.json.bak");
if (success != true) {
Debug.WriteLine("Could not back up the old cache; no replacement attempted.");
return;
}
success = result.WriteFile("qa_data/tokens/outlookCalendar.json");
if (success != true) {
Debug.WriteLine("Could not save the new token; recover the previous cache from the private .bak file.");
return;
}
Debug.WriteLine("Refreshed the calendar token cache.");