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

Outlook Calendar: Retrieve and Update an Event

See more Outlook Calendar Examples

Retrieve an event, then PATCH only the subject, location and reminder fields. Running this changes the event. Use an occurrence ID for one occurrence or the series-master ID for the series. This is not a read/modify/write of the whole resource; omitted properties are retained. The GET does not lock the event, so production applications must choose how to reconcile concurrent edits.

Meeting changes can notify attendees. This example does not overwrite the body or attendee collection. When editing the body of a Teams meeting, preserve its online-meeting content; replacing it wholesale can break the meeting. A location label does not reserve a room. For time changes, supply both dateTime and the appropriate supported timeZone.

Delegated permission: Calendars.ReadWrite.

Uses Microsoft Graph v1.0 in the global cloud with a delegated access token saved by the calendar OAuth2 example. Both personal Outlook.com accounts and Microsoft 365 work/school accounts with a mailbox can use this flow. The app registration must support the selected account type. A token for SMTP/IMAP/POP or another API is not a Graph token.

/me means the signed-in user and requires delegated authentication. An unattended Microsoft 365 service instead needs application permissions and administrator consent, and addresses an explicit mailbox through /users/{id-or-userPrincipalName}. That client-credentials flow does not apply to personal Outlook.com accounts. These samples target the global cloud; national clouds use different authority and Graph hosts.

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_Token
oleobject loo_Http
oleobject loo_Resp
oleobject loo_Result
string ls_EventId
oleobject loo_Endpoint
oleobject loo_Body

li_Success = 0

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
li_Success = 0
//  Obtain a delegated Microsoft Graph token using the calendar authorization example.
//  See Authorize Outlook Calendar with OAuth2 and PKCE.
loo_Token = create oleobject
li_rc = loo_Token.ConnectToNewObject("Chilkat.JsonObject")
if li_rc < 0 then
    destroy loo_Token
    MessageBox("Error","Connecting to COM object failed")
    return
end if
loo_Token.Strict = 1
li_Success = loo_Token.LoadFile("qa_data/tokens/outlookCalendar.json")
if li_Success <> 1 then
    Write-Debug "Could not read the private calendar token cache."
    destroy loo_Token
    return
end if

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

loo_Http = create oleobject
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")

loo_Http.AuthToken = loo_Token.StringOf("access_token")
loo_Http.RequireSslCertVerify = 1
loo_Http.FollowRedirects = 0
loo_Http.ConnectTimeout = 20
loo_Http.ReadTimeout = 30
loo_Http.SetRequestHeader("Accept","application/json")
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
loo_Http.SetRequestHeader("Prefer","outlook.timezone=~"UTC~", IdType=~"ImmutableId~"")
ls_EventId = "YOUR_EVENT_ID"
loo_Endpoint = create oleobject
li_rc = loo_Endpoint.ConnectToNewObject("Chilkat.StringBuilder")

loo_Endpoint.Append("https://graph.microsoft.com/v1.0/me/events/")
loo_Endpoint.Append(loo_Http.UrlEncode(ls_EventId))
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_Token
    destroy loo_Http
    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_Token
    destroy loo_Http
    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_Token
    destroy loo_Http
    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_Token
    destroy loo_Http
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    return
end if

Write-Debug "Current subject: " + loo_Result.StringOf("subject")
Write-Debug "Event type: " + loo_Result.StringOf("type")
//  This is a live change. Updating a meeting can send meeting updates.
loo_Body = create oleobject
li_rc = loo_Body.ConnectToNewObject("Chilkat.JsonObject")

loo_Body.UpdateString("subject","Updated appointment")
loo_Body.UpdateString("location.displayName","Updated location")
loo_Body.UpdateBool("isReminderOn",1)
loo_Body.UpdateInt("reminderMinutesBeforeStart",30)
li_Success = loo_Http.HttpJson("PATCH",loo_Endpoint.GetAsString(),loo_Body,"application/json",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_Token
    destroy loo_Http
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    destroy loo_Body
    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_Token
    destroy loo_Http
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    destroy loo_Body
    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_Token
    destroy loo_Http
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    destroy loo_Body
    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_Token
    destroy loo_Http
    destroy loo_Resp
    destroy loo_Result
    destroy loo_Endpoint
    destroy loo_Body
    return
end if

Write-Debug "Updated event ID: " + loo_Result.StringOf("id")
Write-Debug "Updated subject: " + loo_Result.StringOf("subject")


destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Endpoint
destroy loo_Body