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

Outlook Calendar: Create an All-Day or Multi-Day Event

See more Outlook Calendar Examples

Create a two-day all-day event starting tomorrow in UTC. Both boundaries are midnight in the same time zone, and the end is exclusive: a one-day event ends at midnight on the next calendar date. Change the two-day span to one for a single-day event. showAs="free" is an explicit example choice; use busy or oof when appropriate.

All-day dates are calendar dates, not fixed-duration local hours. When adapting to a local zone, use local midnight boundaries and calendar-date arithmetic; do not assume every daylight-saving day contains 24 hours. The example uses UTC so adding days does not cross a DST offset change.

Live creation: this posts a real calendar item. The request file is saved before sending, including its transactionId, and a receipt records the returned ID. Reuse the saved payload after an uncertain outcome; use a new filename pair for a deliberately new operation. A saved receipt prevents repeat creation on a later successful run. Keep request/receipt files private, per account, and use one writer. See the basic creation example for the same pattern.

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 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
'  Obtain a delegated Microsoft Graph token using the calendar authorization example.
'  See Authorize Outlook Calendar with OAuth2 and PKCE.
Dim token As New ChilkatJsonObject
token.Strict = 1
success = token.LoadFile("qa_data/tokens/outlookCalendar.json")
If (success <> 1) Then
    Debug.Print "Could not read the private calendar token cache."
    Exit Sub
End If

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

Dim http As New ChilkatHttp
http.AuthToken = token.StringOf("access_token")
http.RequireSslCertVerify = 1
http.FollowRedirects = 0
http.ConnectTimeout = 20
http.ReadTimeout = 30
http.SetRequestHeader "Accept","application/json"
Dim resp As New ChilkatHttpResponse
Dim result As New ChilkatJsonObject
result.Strict = 1
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.
Dim requestFile As String
requestFile = "qa_data/outlookCalendar/create-all-day-request.json"
Dim resultFile As String
resultFile = "qa_data/outlookCalendar/created-all-day.json"
Dim fac As New CkFileAccess
success = fac.DirEnsureExists("qa_data/outlookCalendar")
If (success <> 1) Then
    Debug.Print "Could not create the private operation directory."
    Exit Sub
End If

Dim body As New ChilkatJsonObject
body.Strict = 1
If (fac.FileExists(requestFile) = 1) Then
    success = body.LoadFile(requestFile)
    If (success <> 1) Then
        Debug.Print "Could not read the saved create request; nothing sent."
        Exit Sub
    End If

    '  Retry the same saved body and transactionId after an uncertain result.
Else
    Dim day As New CkDateTime
    success = day.SetFromCurrentSystemTime()
    If (success <> 1) Then
        Debug.Print "Could not get the date."
        Exit Sub
    End If

    success = day.AddDays(1)
    If (success <> 1) Then
        Debug.Print "Could not choose the start date."
        Exit Sub
    End If

    Dim midnight As New ChilkatStringBuilder
    success = midnight.Append(day.GetAsIso8601("YYYY-MM-DD",0))
    success = midnight.Append("T00:00:00")
    success = body.UpdateString("start.dateTime",midnight.GetAsString())
    success = body.UpdateString("start.timeZone","UTC")
    success = day.AddDays(2)
    If (success <> 1) Then
        Debug.Print "Could not calculate the exclusive end date."
        Exit Sub
    End If

    midnight.Clear 
    success = midnight.Append(day.GetAsIso8601("YYYY-MM-DD",0))
    success = midnight.Append("T00:00:00")
    success = body.UpdateString("end.dateTime",midnight.GetAsString())
    success = body.UpdateString("end.timeZone","UTC")
    success = body.UpdateString("subject","All-day event")
    success = body.UpdateBool("isAllDay",1)
    success = body.UpdateString("showAs","free")
    '  No attendees: this is an appointment, so the request does not send invitations.
    Dim crypt As New ChilkatCrypt2
    Dim transactionId As String
    transactionId = crypt.GenerateUuid()
    If (crypt.LastMethodSuccess <> 1) Then
        Debug.Print "Could not create a transaction ID."
        Exit Sub
    End If

    success = body.UpdateString("transactionId",transactionId)
    success = body.WriteFile(requestFile)
    If (success <> 1) Then
        Debug.Print "Could not save the request before sending; nothing sent."
        Exit Sub
    End If

End If

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

'  A previous successful run leaves a small receipt. Do not submit it again.
If (fac.FileExists(resultFile) = 1) Then
    Dim receipt As New ChilkatJsonObject
    receipt.Strict = 1
    success = receipt.LoadFile(resultFile)
    If (success <> 1) Then
        Debug.Print "Could not read the existing receipt; nothing sent."
        Exit Sub
    End If

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

    If (receipt.StringOfEquals("transactionId",body.StringOf("transactionId"),1) <> 1) Then
        Debug.Print "The receipt belongs to another operation; nothing sent."
        Exit Sub
    End If

    Debug.Print "Already created event ID: " & receipt.StringOf("id")
    Exit Sub
End If

success = http.HttpJson("POST","https://graph.microsoft.com/v1.0/me/events",body,"application/json",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 <> 201) 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

Dim saved As New ChilkatJsonObject
success = saved.UpdateString("id",result.StringOf("id"))
success = saved.UpdateString("transactionId",body.StringOf("transactionId"))
'  Display the ID even if saving the receipt fails: the server has already created the event.
Debug.Print "Created event ID: " & result.StringOf("id")
success = saved.WriteFile(resultFile)
If (success <> 1) Then
    Debug.Print "The event was created, but its receipt could not be saved. Reconcile before retrying."
    Exit Sub
End If

Debug.Print "Start: " & result.StringOf("start.dateTime") & " (" & result.StringOf("start.timeZone") & ")"
Debug.Print "End: " & result.StringOf("end.dateTime") & " (" & result.StringOf("end.timeZone") & ")"
Debug.Print "Event receipt saved."