Outlook Calendar: Create an Appointment with a Transaction ID
See more Outlook Calendar Examples
Create a one-hour appointment 24 hours from the current time in the default calendar. Requires delegated Calendars.ReadWrite. The subject and body are generic, times are computed at runtime, and no attendees are included. Adding attendees changes this to a meeting and Graph sends invitations; setting a location name alone does not reserve a room.
The example saves the request and its transactionId before sending, then records the returned event ID in a receipt. After an uncertain response, reuse the same payload and transaction ID; do not generate a new UUID for each retry. A receipt prevents an already-successful demonstration run from posting again. For a deliberately new event, use a new pair of request/receipt filenames and a new transaction ID. Keep each operation tied to the same mailbox and serialize access. Production outboxes need durable, atomic storage; this sample does not implement a general retry scheduler or promise indefinite deduplication.
Input dateTime values are paired with timeZone="UTC". For local wall-clock scheduling, choose a mailbox-supported zone and handle daylight-saving transitions explicitly. The response preference requests UTC display and immutable event IDs; preserve the returned ID as a case-sensitive string for later reads or deletion. HTTP 201 confirms creation. A local receipt-write failure does not undo the server operation.
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.
Chilkat PowerBuilder Downloads
integer li_rc
long li_Success
oleobject loo_Token
oleobject loo_Http
oleobject loo_Resp
oleobject loo_Result
string ls_RequestFile
string ls_ResultFile
oleobject loo_Fac
oleobject loo_Body
oleobject loo_When
oleobject loo_Crypt
string ls_TransactionId
oleobject loo_Receipt
oleobject loo_Saved
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~"")
// Live write: creates an appointment in the signed-in user's default calendar.
// Keep one request file per logical operation and account. Do not run concurrent copies.
ls_RequestFile = "qa_data/outlookCalendar/create-event-request.json"
ls_ResultFile = "qa_data/outlookCalendar/created-event.json"
loo_Fac = create oleobject
li_rc = loo_Fac.ConnectToNewObject("Chilkat.FileAccess")
li_Success = loo_Fac.DirEnsureExists("qa_data/outlookCalendar")
if li_Success <> 1 then
Write-Debug "Could not create the private operation directory."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
return
end if
loo_Body = create oleobject
li_rc = loo_Body.ConnectToNewObject("Chilkat.JsonObject")
loo_Body.Strict = 1
if loo_Fac.FileExists(ls_RequestFile) = 1 then
li_Success = loo_Body.LoadFile(ls_RequestFile)
if li_Success <> 1 then
Write-Debug "Could not read the saved create request; nothing sent."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
return
end if
// Retry the same saved body and transactionId after an uncertain result.
else
loo_When = create oleobject
li_rc = loo_When.ConnectToNewObject("Chilkat.CkDateTime")
li_Success = loo_When.SetFromCurrentSystemTime()
if li_Success <> 1 then
Write-Debug "Could not get the current time."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
return
end if
li_Success = loo_When.AddSeconds(86400)
if li_Success <> 1 then
Write-Debug "Could not calculate the event start."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
return
end if
loo_Body.UpdateString("subject","Sample appointment")
loo_Body.UpdateString("body.contentType","text")
loo_Body.UpdateString("body.content","Sample event details.")
loo_Body.UpdateString("start.dateTime",loo_When.GetAsIso8601("YYYY-MM-DDThh:mm:ss",0))
loo_Body.UpdateString("start.timeZone","UTC")
li_Success = loo_When.AddSeconds(3600)
if li_Success <> 1 then
Write-Debug "Could not calculate the event end."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
return
end if
loo_Body.UpdateString("end.dateTime",loo_When.GetAsIso8601("YYYY-MM-DDThh:mm:ss",0))
loo_Body.UpdateString("end.timeZone","UTC")
loo_Body.UpdateString("showAs","busy")
loo_Body.UpdateBool("isReminderOn",1)
loo_Body.UpdateInt("reminderMinutesBeforeStart",15)
// No attendees: this is an appointment, so the request does not send invitations.
loo_Crypt = create oleobject
li_rc = loo_Crypt.ConnectToNewObject("Chilkat.Crypt2")
ls_TransactionId = loo_Crypt.GenerateUuid()
if loo_Crypt.LastMethodSuccess <> 1 then
Write-Debug "Could not create a transaction ID."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
return
end if
loo_Body.UpdateString("transactionId",ls_TransactionId)
li_Success = loo_Body.WriteFile(ls_RequestFile)
if li_Success <> 1 then
Write-Debug "Could not save the request before sending; nothing sent."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
return
end if
end if
if (loo_Body.JsonTypeOf("transactionId") <> 1) OR (loo_Body.StringOfEquals("transactionId","",1) = 1) then
Write-Debug "Expected a nonempty transactionId in the JSON."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
return
end if
// A previous successful run leaves a small receipt. Do not submit it again.
if loo_Fac.FileExists(ls_ResultFile) = 1 then
loo_Receipt = create oleobject
li_rc = loo_Receipt.ConnectToNewObject("Chilkat.JsonObject")
loo_Receipt.Strict = 1
li_Success = loo_Receipt.LoadFile(ls_ResultFile)
if li_Success <> 1 then
Write-Debug "Could not read the existing receipt; nothing sent."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
return
end if
if (loo_Receipt.JsonTypeOf("id") <> 1) OR (loo_Receipt.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_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
return
end if
if loo_Receipt.StringOfEquals("transactionId",loo_Body.StringOf("transactionId"),1) <> 1 then
Write-Debug "The receipt belongs to another operation; nothing sent."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
return
end if
Write-Debug "Already created event ID: " + loo_Receipt.StringOf("id")
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
return
end if
li_Success = loo_Http.HttpJson("POST","https://graph.microsoft.com/v1.0/me/events",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_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
return
end if
if loo_Resp.StatusCode <> 201 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_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
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_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
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_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
return
end if
loo_Saved = create oleobject
li_rc = loo_Saved.ConnectToNewObject("Chilkat.JsonObject")
loo_Saved.UpdateString("id",loo_Result.StringOf("id"))
loo_Saved.UpdateString("transactionId",loo_Body.StringOf("transactionId"))
// Display the ID even if saving the receipt fails: the server has already created the event.
Write-Debug "Created event ID: " + loo_Result.StringOf("id")
li_Success = loo_Saved.WriteFile(ls_ResultFile)
if li_Success <> 1 then
Write-Debug "The event was created, but its receipt could not be saved. Reconcile before retrying."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
destroy loo_Saved
return
end if
Write-Debug "Start: " + loo_Result.StringOf("start.dateTime") + " (" + loo_Result.StringOf("start.timeZone") + ")"
Write-Debug "End: " + loo_Result.StringOf("end.dateTime") + " (" + loo_Result.StringOf("end.timeZone") + ")"
Write-Debug "Event receipt saved."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_Fac
destroy loo_Body
destroy loo_When
destroy loo_Crypt
destroy loo_Receipt
destroy loo_Saved