{"title":"Codeunit 1140 OAuth 2.0 Mgt., procedures","url":"https://jonas-paprotka.de/ref/codeunit/1140-oauth-2-0-mgt/procedures/","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":"procedures","total":24,"rows":[{"name":"RequestAuthFromNotification","sig":"(Notification)","named":"(AuthNotification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AuthNotification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(OAuth20Setup: Record \"OAuth 2.0 Setup\"; ClientID: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"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"}}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"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":null},{"from":24,"to":26,"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"}}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"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":null},{"from":24,"to":26,"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"}}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"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":null},{"from":24,"to":26,"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"}}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"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":null},{"from":24,"to":26,"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"}}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"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":null},{"from":24,"to":26,"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"}}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"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":null},{"from":24,"to":26,"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"}}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"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":null},{"from":24,"to":26,"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"}}]},{"name":"RequestAuthorizationCode","sig":"(Record OAuth 2.0 Setup)","named":"(OAuth20Setup: Record \"OAuth 2.0 Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(OAuth20Setup: Record \"OAuth 2.0 Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"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"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"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"}}]},{"name":"RefreshAndSaveAccessToken","sig":"(var Record OAuth 2.0 Setup, var Text)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"InvokeRequestBasic","sig":"(var Record OAuth 2.0 Setup, Text, var Text, var Text, Boolean)","named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJSON: Text; var ResponseJSON: Text; var HttpError: Text; RetryOnCredentialsFailure: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; RequestJSON: Text; var ResponseJSON: Text; var HttpError: Text; RetryOnCredentialsFailure: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"CheckEncryption","sig":"()","named":"()","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetHttpStatusFromJsonResponse","sig":"(Text, var Integer, var Text, var Text)","named":"(JsonString: Text; var StatusCode: Integer; var StatusReason: Text; var StatusDetails: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(JsonString: Text; var StatusCode: Integer; var StatusReason: Text; var StatusDetails: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(OAuth20Setup: Record \"OAuth 2.0 Setup\"; ClientID: Text)","returns":"SecretText","kind":"procedure","access":"public","obsolete":null}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"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}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"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}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"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}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"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}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"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}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"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}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"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}]},{"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,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(var OAuth20Setup: Record \"OAuth 2.0 Setup\"; var MessageText: Text; AuthorizationCode: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]}]}