{"title":"Codeunit 1140 OAuth 2.0 Mgt., changes","url":"https://jonas-paprotka.de/ref/codeunit/1140-oauth-2-0-mgt/changes/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":1140,"name":"OAuth 2.0 Mgt.","app":"Base Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/1140-oauth-2-0-mgt/","json":"https://jonas-paprotka.de/ref/codeunit/1140-oauth-2-0-mgt.json"},"aspect":"changes","total":29,"rows":[{"version":27,"kind":"procedure","change":"gone","name":"GetAuthorizationURL","member":{"name":"GetAuthorizationURL","sig":"(Record OAuth 2.0 Setup, Text)","named":"(OAuth20Setup: Record \"OAuth 2.0 Setup\"; ClientID: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use procedure GetAuthorizationURLAsSecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"RequestAccessToken","member":{"name":"RequestAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RequestAccessToken procedure with parameters declared as SecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"RequestAccessTokenWithGivenRequestJson","member":{"name":"RequestAccessTokenWithGivenRequestJson","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; AuthorizationCode: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RequestAccessTokenWithGivenRequestJson with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"RequestAccessTokenWithContentType","member":{"name":"RequestAccessTokenWithContentType","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, Text, var Text, var Text, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; AuthorizationCode: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text; UseUrlEncodedContentType: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use \"RequestAccessTokenWithContentType with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"RefreshAccessToken","member":{"name":"RefreshAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RefreshAccessToken with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"RefreshAccessTokenWithGivenRequestJson","member":{"name":"RefreshAccessTokenWithGivenRequestJson","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RefreshAccessTokenWithGivenRequestJson with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"RefreshAccessTokenWithContentType","member":{"name":"RefreshAccessTokenWithContentType","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, var Text, var Text, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text; UseUrlEncodedContentType: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RefreshAccessTokenWithContentType with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"InvokeRequest","member":{"name":"InvokeRequest","sig":"(var Record OAuth 2.0 Setup, Text, var Text, var Text, Text, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var ResponseJson: Text; var HttpError: Text; AccessToken: Text; RetryOnCredentialsFailure: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use InvokeRequest with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":27,"kind":"procedure","change":"gone","name":"RequestAndSaveAccessToken","member":{"name":"RequestAndSaveAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RequestAndSaveAccessToken with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"GetAuthorizationURL","member":{"name":"GetAuthorizationURL","sig":"(Record OAuth 2.0 Setup, Text)","named":"(OAuth20Setup: Record \"OAuth 2.0 Setup\"; ClientID: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use procedure GetAuthorizationURLAsSecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"RequestAccessToken","member":{"name":"RequestAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RequestAccessToken procedure with parameters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"RequestAccessTokenWithGivenRequestJson","member":{"name":"RequestAccessTokenWithGivenRequestJson","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; AuthorizationCode: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RequestAccessTokenWithGivenRequestJson with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"RequestAccessTokenWithContentType","member":{"name":"RequestAccessTokenWithContentType","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, Text, var Text, var Text, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; AuthorizationCode: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text; UseUrlEncodedContentType: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use \"RequestAccessTokenWithContentType with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"RefreshAccessToken","member":{"name":"RefreshAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RefreshAccessToken with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"RefreshAccessTokenWithGivenRequestJson","member":{"name":"RefreshAccessTokenWithGivenRequestJson","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, var Text, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RefreshAccessTokenWithGivenRequestJson with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"RefreshAccessTokenWithContentType","member":{"name":"RefreshAccessTokenWithContentType","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, Text, var Text, var Text, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; ClientID: Text; ClientSecret: Text; var AccessToken: Text; var RefreshToken: Text; UseUrlEncodedContentType: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RefreshAccessTokenWithContentType with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"InvokeRequest","member":{"name":"InvokeRequest","sig":"(var Record OAuth 2.0 Setup, Text, var Text, var Text, Text, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var ResponseJson: Text; var HttpError: Text; AccessToken: Text; RetryOnCredentialsFailure: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use InvokeRequest with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"marked","name":"RequestAndSaveAccessToken","member":{"name":"RequestAndSaveAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use RequestAndSaveAccessToken with paramaters declared as SecretText instead.","tag":"24.0"}}},{"version":24,"kind":"procedure","change":"added","name":"GetAuthorizationURLAsSecretText","member":{"name":"GetAuthorizationURLAsSecretText","sig":"(Record OAuth 2.0 Setup, Text)","named":"(OAuth20Setup: Record \"OAuth 2.0 Setup\"; ClientID: Text)","returns":"SecretText","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"RequestAccessToken","member":{"name":"RequestAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, SecretText, Text, SecretText, var SecretText, var SecretText)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: SecretText; ClientID: Text; ClientSecret: SecretText; var AccessToken: SecretText; var RefreshToken: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"RequestAccessTokenWithGivenRequestJson","member":{"name":"RequestAccessTokenWithGivenRequestJson","sig":"(var Record OAuth 2.0 Setup, Text, var Text, SecretText, Text, SecretText, var SecretText, var SecretText)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; AuthorizationCode: SecretText; ClientID: Text; ClientSecret: SecretText; var AccessToken: SecretText; var RefreshToken: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"RequestAccessTokenWithContentType","member":{"name":"RequestAccessTokenWithContentType","sig":"(var Record OAuth 2.0 Setup, Text, var Text, SecretText, Text, SecretText, var SecretText, var SecretText, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; AuthorizationCode: SecretText; ClientID: Text; ClientSecret: SecretText; var AccessToken: SecretText; var RefreshToken: SecretText; UseUrlEncodedContentType: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"RefreshAccessToken","member":{"name":"RefreshAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, Text, SecretText, var SecretText, var SecretText)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; ClientID: Text; ClientSecret: SecretText; var AccessToken: SecretText; var RefreshToken: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"RefreshAccessTokenWithGivenRequestJson","member":{"name":"RefreshAccessTokenWithGivenRequestJson","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, SecretText, var SecretText, var SecretText)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; ClientID: Text; ClientSecret: SecretText; var AccessToken: SecretText; var RefreshToken: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"RefreshAccessTokenWithContentType","member":{"name":"RefreshAccessTokenWithContentType","sig":"(var Record OAuth 2.0 Setup, Text, var Text, Text, SecretText, var SecretText, var SecretText, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var MessageText: Text; ClientID: Text; ClientSecret: SecretText; var AccessToken: SecretText; var RefreshToken: SecretText; UseUrlEncodedContentType: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"InvokeRequest","member":{"name":"InvokeRequest","sig":"(var Record OAuth 2.0 Setup, Text, var Text, var Text, SecretText, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJson: Text; var ResponseJson: Text; var HttpError: Text; AccessToken: SecretText; RetryOnCredentialsFailure: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"RequestAndSaveAccessToken","member":{"name":"RequestAndSaveAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text, SecretText)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":23,"kind":"event","change":"added","name":"OnBeforeGetServiceUrlForAuthorizationURL","member":{"name":"OnBeforeGetServiceUrlForAuthorizationURL","sig":"(var Text, Record OAuth 2.0 Setup)","named":"(var ServiceUrl: Text; OAuth20Setup: Record \"OAuth 2.0 Setup\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnBeforeCheckEncryption","member":{"name":"OnBeforeCheckEncryption","sig":"(var Boolean)","named":"(var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}}]}