Sample code for 30+ languages & platforms
C# Requires Chilkat v11.0.0+

Outlook.com: Refresh Mail OAuth2 Tokens

See more Office365 Examples

Exchange a saved delegated refresh token for a new access token without displaying a browser. Use the same app registration and authority as the original authorization. Save any rotated refresh token and the new lifetime information. On a rejected or malformed response, this example preserves the previous cache; an expired/revoked grant or interaction-required response needs interactive authorization again.

Read and update qa_data/tokens/hotmail.json in a private working directory. Serialize access to the cache; production storage should support atomic replacement and protect credentials. A successful refresh does not enable a disabled mail protocol. Client-credentials tokens have no refresh token; request a new application token instead.

Authorize first: desktop PKCE example. This is delegated background access after consent, not permanently unattended application authentication.

Microsoft reference documentation

Chilkat C# Downloads

C#
bool success = false;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

Chilkat.JsonObject token = new Chilkat.JsonObject();
success = token.LoadFile("qa_data/tokens/hotmail.json");
if (success != true) {
    Debug.WriteLine("Could not read qa_data/tokens/hotmail.json from the private working directory.");
    return;
}

if ((token.JsonTypeOf("refresh_token") != 1) || (token.StringOfEquals("refresh_token","",true) == true)) {
    Debug.WriteLine("Authorize the account for offline access first.");
    return;
}

Chilkat.OAuth2 oauth = new Chilkat.OAuth2();
oauth.TokenEndpoint = "https://login.microsoftonline.com/consumers/oauth2/v2.0/token";
oauth.ClientId = "CLIENT_ID";
//  No client secret for the public desktop registration used by the PKCE example.
oauth.RefreshToken = token.StringOf("refresh_token");
success = oauth.RefreshAccessToken();
if (success != true) {
    Debug.WriteLine("Refresh failed. Check the OAuth client and grant. A revoked or expired grant requires fresh consent.");
    return;
}

Chilkat.JsonObject fresh = new Chilkat.JsonObject();
success = fresh.Load(oauth.AccessTokenResponse);
if (success != true) {
    Debug.WriteLine("Could not parse the refresh response.");
    return;
}

if ((fresh.JsonTypeOf("access_token") != 1) || (fresh.StringOfEquals("access_token","",true) == true)) {
    Debug.WriteLine("The refresh response did not contain an access token.");
    return;
}

if ((fresh.JsonTypeOf("refresh_token") != 1) || (fresh.StringOfEquals("refresh_token","",true) == true)) {
    fresh.UpdateString("refresh_token",token.StringOf("refresh_token"));
}

if ((fresh.HasMember("scope") != true) && (token.JsonTypeOf("scope") == 1)) {
    fresh.UpdateString("scope",token.StringOf("scope"));
}

//  Persist the rotated refresh token. Retain the previous one only if the response omits it.
//  Use the new expires_in, not the old response's expiration information.
Chilkat.CkDateTime obtained = new Chilkat.CkDateTime();
obtained.SetFromCurrentSystemTime();
fresh.UpdateString("obtained_at",obtained.GetAsTimestamp(false));
success = fresh.WriteFile("qa_data/tokens/hotmail.json");
if (success != true) {
    Debug.WriteLine("Could not save the refreshed credentials.");
    return;
}

Debug.WriteLine("Refreshed the access token.");