Sample code for 30+ languages & platforms
Visual Basic 6.0 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 Visual Basic 6.0 Downloads

Visual Basic 6.0
Dim success As Long
success = 0

'  Assumes Chilkat is unlocked. See Global Unlock Sample.
success = 0
Dim config As New ChilkatJsonObject
config.Strict = 1
success = config.LoadFile("outlook-calendar-app.json")
If (success <> 1) Then
    Debug.Print "Could not load private app configuration."
    Exit Sub
End If

If ((config.JsonTypeOf("tenant_id") <> 1) Or (config.StringOfEquals("tenant_id","",1) = 1)) Then
    Debug.Print "Expected a nonempty tenant_id in the JSON."
    Exit Sub
End If

If ((config.JsonTypeOf("client_id") <> 1) Or (config.StringOfEquals("client_id","",1) = 1)) Then
    Debug.Print "Expected a nonempty client_id in the JSON."
    Exit Sub
End If

If ((config.JsonTypeOf("mailbox") <> 1) Or (config.StringOfEquals("mailbox","",1) = 1)) Then
    Debug.Print "Expected a nonempty mailbox in the JSON."
    Exit Sub
End If

If ((config.JsonTypeOf("pfx_path") <> 1) Or (config.StringOfEquals("pfx_path","",1) = 1)) Then
    Debug.Print "Expected a nonempty pfx_path in the JSON."
    Exit Sub
End If

'  pfx_password may be empty for an unencrypted test PFX; protect the private key in production.
Dim http As New ChilkatHttp
http.RequireSslCertVerify = 1
http.FollowRedirects = 0
http.ConnectTimeout = 20
http.ReadTimeout = 30
Dim tokenEndpoint As New ChilkatStringBuilder
success = tokenEndpoint.Append("https://login.microsoftonline.com/")
success = tokenEndpoint.Append(http.UrlEncode(config.StringOf("tenant_id")))
success = tokenEndpoint.Append("/oauth2/v2.0/token")
Dim tokenUrl As String
tokenUrl = tokenEndpoint.GetAsString()
Dim cert As New ChilkatCert
success = cert.LoadPfxFile(config.StringOf("pfx_path"),config.StringOf("pfx_password"))
If (success <> 1) Then
    Debug.Print "Could not load the application certificate."
    Exit Sub
End If

Dim key As New PrivateKey
success = cert.GetPrivateKey(key)
If (success <> 1) Then
    Debug.Print "The certificate needs an accessible RSA private key."
    Exit Sub
End If

Dim der As New ChilkatBinData
success = cert.ExportCertDerBd(der)
If (success <> 1) Then
    Debug.Print "Could not read the certificate DER bytes."
    Exit Sub
End If

Dim crypt As New ChilkatCrypt2
crypt.HashAlgorithm = "sha256"
crypt.EncodingMode = "base64url"
Dim thumbprint As String
thumbprint = crypt.HashBdENC(der)
If (crypt.LastMethodSuccess <> 1) Then
    Debug.Print "Could not hash the certificate."
    Exit Sub
End If

Dim header As New ChilkatJsonObject
success = header.UpdateString("alg","PS256")
success = header.UpdateString("typ","JWT")
success = header.UpdateString("x5t#S256",thumbprint)
Dim claims As New ChilkatJsonObject
success = claims.UpdateString("aud",tokenUrl)
success = claims.UpdateString("iss",config.StringOf("client_id"))
success = claims.UpdateString("sub",config.StringOf("client_id"))
Dim assertionId As String
assertionId = crypt.GenerateUuid()
If (crypt.LastMethodSuccess <> 1) Then
    Debug.Print "Could not create the assertion ID."
    Exit Sub
End If

success = claims.UpdateString("jti",assertionId)
Dim clock As New CkDateTime
success = clock.SetFromCurrentSystemTime()
If (success <> 1) Then
    Debug.Print "Could not read the clock."
    Exit Sub
End If

'  Numeric dates are JSON numbers built from decimal strings, without converting timestamps to a platform-sized integer.
success = claims.UpdateNumber("iat",clock.GetAsUnixTimeStr(0))
success = claims.UpdateNumber("nbf",clock.GetAsUnixTimeStr(0))
success = clock.AddSeconds(300)
If (success <> 1) Then
    Debug.Print "Could not set assertion expiry."
    Exit Sub
End If

success = claims.UpdateNumber("exp",clock.GetAsUnixTimeStr(0))
Dim jwt As New ChilkatJwt
Dim assertion As String
assertion = jwt.CreateJwtPk(header.Emit(),claims.Emit(),key)
If (jwt.LastMethodSuccess <> 1) Then
    Debug.Print "Could not sign the client assertion."
    Exit Sub
End If

Dim req As New ChilkatHttpRequest
req.HttpVerb = "POST"
req.ContentType = "application/x-www-form-urlencoded"
req.AddParam "client_id",config.StringOf("client_id")
req.AddParam "grant_type","client_credentials"
req.AddParam "scope","https://graph.microsoft.com/.default"
req.AddParam "client_assertion_type","urn:ietf:params:oauth:client-assertion-type:jwt-bearer"
req.AddParam "client_assertion",assertion
Dim resp As New ChilkatHttpResponse
Dim result As New ChilkatJsonObject
result.Strict = 1
success = http.HttpReq(tokenUrl,req,resp)
'  A false result can still include an HTTP error response.
If ((success <> 1) And (resp.StatusCode = 0)) Then
    Debug.Print "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
    Exit Sub
End If

If (resp.StatusCode <> 200) Then
    Debug.Print "Unexpected HTTP status: " & resp.StatusCode
    Debug.Print "Request ID: " & resp.GetHeaderField("request-id")
    If (resp.StatusCode = 429) Then
        Debug.Print "Retry-After: " & resp.GetHeaderField("Retry-After")
    End If

    If (resp.StatusCode = 401) Then
        Debug.Print "Refresh the Graph access token or authorize again."
    End If

    Exit Sub
End If

success = result.Load(resp.BodyStr)
If (success <> 1) Then
    Debug.Print "Expected a well-formed JSON response."
    Exit Sub
End If

If ((result.JsonTypeOf("access_token") <> 1) Or (result.StringOfEquals("access_token","",1) = 1)) Then
    Debug.Print "Expected a nonempty access_token in the JSON."
    Exit Sub
End If

http.AuthToken = result.StringOf("access_token")
'  App-only tokens have no /me. Address the approved mailbox explicitly.
Dim endpoint As New ChilkatStringBuilder
success = endpoint.Append("https://graph.microsoft.com/v1.0/users/")
success = endpoint.Append(http.UrlEncode(config.StringOf("mailbox")))
success = endpoint.Append("/calendar?$select=id,name,canEdit")
success = http.HttpNoBody("GET",endpoint.GetAsString(),resp)
'  A false result can still include an HTTP error response.
If ((success <> 1) And (resp.StatusCode = 0)) Then
    Debug.Print "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
    Exit Sub
End If

If (resp.StatusCode <> 200) Then
    Debug.Print "Unexpected HTTP status: " & resp.StatusCode
    Debug.Print "Request ID: " & resp.GetHeaderField("request-id")
    If (resp.StatusCode = 429) Then
        Debug.Print "Retry-After: " & resp.GetHeaderField("Retry-After")
    End If

    If (resp.StatusCode = 401) Then
        Debug.Print "Refresh the Graph access token or authorize again."
    End If

    Exit Sub
End If

success = result.Load(resp.BodyStr)
If (success <> 1) Then
    Debug.Print "Expected a well-formed JSON response."
    Exit Sub
End If

If ((result.JsonTypeOf("id") <> 1) Or (result.StringOfEquals("id","",1) = 1)) Then
    Debug.Print "Expected a nonempty id in the JSON."
    Exit Sub
End If

Debug.Print "Calendar ID: " & result.StringOf("id")
Debug.Print "Calendar name: " & result.StringOf("name")