Sample code for 30+ languages & platforms
PowerBuilder Requires Chilkat v11.6.0+

Outlook Calendar: Access a Microsoft 365 Calendar with a Certificate

See more Outlook Calendar Examples

Obtain an app-only Graph token using a signed certificate assertion, then read an explicitly named Microsoft 365 mailbox's default calendar. Upload the public certificate to the Entra app registration and keep its RSA private key private. Grant the appropriate Graph application permission and administrator consent: Calendars.ReadBasic for this read, or a stronger permission only for the operations required. Scope mailbox access using your organization's supported Exchange application-access controls/RBAC; avoid unintended tenant-wide access.

Private outlook-calendar-app.json contains tenant_id (the directory ID), client_id (Application ID), mailbox (object ID or UPN), pfx_path, and pfx_password. Use an organization tenant, not common/consumers. This is not available for personal Outlook.com mailboxes. Certificate authentication is not a requirement to run a public web server, but the private key must remain in a trusted application environment.

The short-lived assertion uses PS256 and an x5t#S256 thumbprint of the certificate's DER bytes. It is a credential submitted only to the token endpoint, not the Graph bearer token. Client credentials returns no refresh token: obtain another access token with a fresh assertion when needed. The example never prints tokens or assertions.

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.

Microsoft documentation

Chilkat PowerBuilder Downloads

PowerBuilder
integer li_rc
long li_Success
oleobject loo_Config
oleobject loo_Http
oleobject loo_TokenEndpoint
string ls_TokenUrl
oleobject loo_Cert
oleobject loo_Key
oleobject loo_Der
oleobject loo_Crypt
string ls_Thumbprint
oleobject loo_Header
oleobject loo_Claims
string ls_AssertionId
oleobject loo_Clock
oleobject loo_Jwt
string ls_Assertion
oleobject loo_Req
oleobject loo_Resp
oleobject loo_Result
oleobject loo_Endpoint

li_Success = 0

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
li_Success = 0
loo_Config = create oleobject
li_rc = loo_Config.ConnectToNewObject("Chilkat.JsonObject")
if li_rc < 0 then
    destroy loo_Config
    MessageBox("Error","Connecting to COM object failed")
    return
end if
loo_Config.Strict = 1
li_Success = loo_Config.LoadFile("outlook-calendar-app.json")
if li_Success <> 1 then
    Write-Debug "Could not load private app configuration."
    destroy loo_Config
    return
end if

if (loo_Config.JsonTypeOf("tenant_id") <> 1) OR (loo_Config.StringOfEquals("tenant_id","",1) = 1) then
    Write-Debug "Expected a nonempty tenant_id in the JSON."
    destroy loo_Config
    return
end if

if (loo_Config.JsonTypeOf("client_id") <> 1) OR (loo_Config.StringOfEquals("client_id","",1) = 1) then
    Write-Debug "Expected a nonempty client_id in the JSON."
    destroy loo_Config
    return
end if

if (loo_Config.JsonTypeOf("mailbox") <> 1) OR (loo_Config.StringOfEquals("mailbox","",1) = 1) then
    Write-Debug "Expected a nonempty mailbox in the JSON."
    destroy loo_Config
    return
end if

if (loo_Config.JsonTypeOf("pfx_path") <> 1) OR (loo_Config.StringOfEquals("pfx_path","",1) = 1) then
    Write-Debug "Expected a nonempty pfx_path in the JSON."
    destroy loo_Config
    return
end if

//  pfx_password may be empty for an unencrypted test PFX; protect the private key in production.
loo_Http = create oleobject
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")

loo_Http.RequireSslCertVerify = 1
loo_Http.FollowRedirects = 0
loo_Http.ConnectTimeout = 20
loo_Http.ReadTimeout = 30
loo_TokenEndpoint = create oleobject
li_rc = loo_TokenEndpoint.ConnectToNewObject("Chilkat.StringBuilder")

loo_TokenEndpoint.Append("https://login.microsoftonline.com/")
loo_TokenEndpoint.Append(loo_Http.UrlEncode(loo_Config.StringOf("tenant_id")))
loo_TokenEndpoint.Append("/oauth2/v2.0/token")
ls_TokenUrl = loo_TokenEndpoint.GetAsString()
loo_Cert = create oleobject
li_rc = loo_Cert.ConnectToNewObject("Chilkat.Cert")

li_Success = loo_Cert.LoadPfxFile(loo_Config.StringOf("pfx_path"),loo_Config.StringOf("pfx_password"))
if li_Success <> 1 then
    Write-Debug "Could not load the application certificate."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    return
end if

loo_Key = create oleobject
li_rc = loo_Key.ConnectToNewObject("Chilkat.PrivateKey")

li_Success = loo_Cert.GetPrivateKey(loo_Key)
if li_Success <> 1 then
    Write-Debug "The certificate needs an accessible RSA private key."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    return
end if

loo_Der = create oleobject
li_rc = loo_Der.ConnectToNewObject("Chilkat.BinData")

li_Success = loo_Cert.ExportCertDerBd(loo_Der)
if li_Success <> 1 then
    Write-Debug "Could not read the certificate DER bytes."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    return
end if

loo_Crypt = create oleobject
li_rc = loo_Crypt.ConnectToNewObject("Chilkat.Crypt2")

loo_Crypt.HashAlgorithm = "sha256"
loo_Crypt.EncodingMode = "base64url"
ls_Thumbprint = loo_Crypt.HashBdENC(loo_Der)
if loo_Crypt.LastMethodSuccess <> 1 then
    Write-Debug "Could not hash the certificate."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    return
end if

loo_Header = create oleobject
li_rc = loo_Header.ConnectToNewObject("Chilkat.JsonObject")

loo_Header.UpdateString("alg","PS256")
loo_Header.UpdateString("typ","JWT")
loo_Header.UpdateString("x5t#S256",ls_Thumbprint)
loo_Claims = create oleobject
li_rc = loo_Claims.ConnectToNewObject("Chilkat.JsonObject")

loo_Claims.UpdateString("aud",ls_TokenUrl)
loo_Claims.UpdateString("iss",loo_Config.StringOf("client_id"))
loo_Claims.UpdateString("sub",loo_Config.StringOf("client_id"))
ls_AssertionId = loo_Crypt.GenerateUuid()
if loo_Crypt.LastMethodSuccess <> 1 then
    Write-Debug "Could not create the assertion ID."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    return
end if

loo_Claims.UpdateString("jti",ls_AssertionId)
loo_Clock = create oleobject
li_rc = loo_Clock.ConnectToNewObject("Chilkat.CkDateTime")

li_Success = loo_Clock.SetFromCurrentSystemTime()
if li_Success <> 1 then
    Write-Debug "Could not read the clock."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    return
end if

//  Numeric dates are JSON numbers built from decimal strings, without converting timestamps to a platform-sized integer.
loo_Claims.UpdateNumber("iat",loo_Clock.GetAsUnixTimeStr(0))
loo_Claims.UpdateNumber("nbf",loo_Clock.GetAsUnixTimeStr(0))
li_Success = loo_Clock.AddSeconds(300)
if li_Success <> 1 then
    Write-Debug "Could not set assertion expiry."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    return
end if

loo_Claims.UpdateNumber("exp",loo_Clock.GetAsUnixTimeStr(0))
loo_Jwt = create oleobject
li_rc = loo_Jwt.ConnectToNewObject("Chilkat.Jwt")

ls_Assertion = loo_Jwt.CreateJwtPk(loo_Header.Emit(),loo_Claims.Emit(),loo_Key)
if loo_Jwt.LastMethodSuccess <> 1 then
    Write-Debug "Could not sign the client assertion."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    return
end if

loo_Req = create oleobject
li_rc = loo_Req.ConnectToNewObject("Chilkat.HttpRequest")

loo_Req.HttpVerb = "POST"
loo_Req.ContentType = "application/x-www-form-urlencoded"
loo_Req.AddParam("client_id",loo_Config.StringOf("client_id"))
loo_Req.AddParam("grant_type","client_credentials")
loo_Req.AddParam("scope","https://graph.microsoft.com/.default")
loo_Req.AddParam("client_assertion_type","urn:ietf:params:oauth:client-assertion-type:jwt-bearer")
loo_Req.AddParam("client_assertion",ls_Assertion)
loo_Resp = create oleobject
li_rc = loo_Resp.ConnectToNewObject("Chilkat.HttpResponse")

loo_Result = create oleobject
li_rc = loo_Result.ConnectToNewObject("Chilkat.JsonObject")

loo_Result.Strict = 1
li_Success = loo_Http.HttpReq(ls_TokenUrl,loo_Req,loo_Resp)
//  A false result can still include an HTTP error response.
if (li_Success <> 1) AND (loo_Resp.StatusCode = 0) then
    Write-Debug "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    return
end if

if loo_Resp.StatusCode <> 200 then
    Write-Debug "Unexpected HTTP status: " + string(loo_Resp.StatusCode)
    Write-Debug "Request ID: " + loo_Resp.GetHeaderField("request-id")
    if loo_Resp.StatusCode = 429 then
        Write-Debug "Retry-After: " + loo_Resp.GetHeaderField("Retry-After")
    end if

    if loo_Resp.StatusCode = 401 then
        Write-Debug "Refresh the Graph access token or authorize again."
    end if

    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    return
end if

li_Success = loo_Result.Load(loo_Resp.BodyStr)
if li_Success <> 1 then
    Write-Debug "Expected a well-formed JSON response."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    return
end if

if (loo_Result.JsonTypeOf("access_token") <> 1) OR (loo_Result.StringOfEquals("access_token","",1) = 1) then
    Write-Debug "Expected a nonempty access_token in the JSON."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    return
end if

loo_Http.AuthToken = loo_Result.StringOf("access_token")
//  App-only tokens have no /me. Address the approved mailbox explicitly.
loo_Endpoint = create oleobject
li_rc = loo_Endpoint.ConnectToNewObject("Chilkat.StringBuilder")

loo_Endpoint.Append("https://graph.microsoft.com/v1.0/users/")
loo_Endpoint.Append(loo_Http.UrlEncode(loo_Config.StringOf("mailbox")))
loo_Endpoint.Append("/calendar?$select=id,name,canEdit")
li_Success = loo_Http.HttpNoBody("GET",loo_Endpoint.GetAsString(),loo_Resp)
//  A false result can still include an HTTP error response.
if (li_Success <> 1) AND (loo_Resp.StatusCode = 0) then
    Write-Debug "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    return
end if

if loo_Resp.StatusCode <> 200 then
    Write-Debug "Unexpected HTTP status: " + string(loo_Resp.StatusCode)
    Write-Debug "Request ID: " + loo_Resp.GetHeaderField("request-id")
    if loo_Resp.StatusCode = 429 then
        Write-Debug "Retry-After: " + loo_Resp.GetHeaderField("Retry-After")
    end if

    if loo_Resp.StatusCode = 401 then
        Write-Debug "Refresh the Graph access token or authorize again."
    end if

    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    return
end if

li_Success = loo_Result.Load(loo_Resp.BodyStr)
if li_Success <> 1 then
    Write-Debug "Expected a well-formed JSON response."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    return
end if

if (loo_Result.JsonTypeOf("id") <> 1) OR (loo_Result.StringOfEquals("id","",1) = 1) then
    Write-Debug "Expected a nonempty id in the JSON."
    destroy loo_Config
    destroy loo_Http
    destroy loo_TokenEndpoint
    destroy loo_Cert
    destroy loo_Key
    destroy loo_Der
    destroy loo_Crypt
    destroy loo_Header
    destroy loo_Claims
    destroy loo_Clock
    destroy loo_Jwt
    destroy loo_Req
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    return
end if

Write-Debug "Calendar ID: " + loo_Result.StringOf("id")
Write-Debug "Calendar name: " + loo_Result.StringOf("name")


destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
destroy loo_Endpoint