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

Outlook Calendar: Create a Meeting with Attendees and Optional Teams

See more Outlook Calendar Examples

Sends invitations: replace attendee@example.com with an intended recipient before running. Graph sends invitations when attendees are supplied. This example creates a one-hour meeting tomorrow and saves its ID. The responseRequested property asks attendees for responses; it is not a switch to suppress the invitations.

Set enableTeams=true for a supported Microsoft 365 calendar. The example checks allowedOnlineMeetingProviders before creating a new request, sets isOnlineMeeting and teamsForBusiness, and reads onlineMeeting.joinUrl. This uses the calendar API, not the standalone onlineMeetings API. With enableTeams=false it creates an ordinary meeting. A persisted request retains its original settings on retry; do not change settings underneath the same transaction ID.

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 PowerBuilder Downloads

PowerBuilder
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
long li_EnableTeams
oleobject loo_Body
long li_TeamsAllowed
long li_ProviderIndex
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 a meeting and sends invitations 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-meeting-request.json"
ls_ResultFile = "qa_data/outlookCalendar/created-meeting.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

//  Set true only for a Teams-enabled organizational calendar.
li_EnableTeams = 0
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
    if li_EnableTeams = 1 then
        li_Success = loo_Http.HttpNoBody("GET","https://graph.microsoft.com/v1.0/me/calendar?$select=allowedOnlineMeetingProviders",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
            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_Fac
            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_Fac
            destroy loo_Body
            return
        end if

        if loo_Result.JsonTypeOf("allowedOnlineMeetingProviders") <> 4 then
            Write-Debug "Could not determine supported meeting providers."
            destroy loo_Token
            destroy loo_Http
            destroy loo_Resp
            destroy loo_Result
            destroy loo_Fac
            destroy loo_Body
            return
        end if

        li_TeamsAllowed = 0
        li_ProviderIndex = 0
        do while (li_ProviderIndex < loo_Result.SizeOfArray("allowedOnlineMeetingProviders"))
            loo_Result.I = li_ProviderIndex
            if loo_Result.StringOfEquals("allowedOnlineMeetingProviders[i]","teamsForBusiness",1) = 1 then
                li_TeamsAllowed = 1
            end if

            li_ProviderIndex = li_ProviderIndex + 1
        loop
        if li_TeamsAllowed <> 1 then
            Write-Debug "This calendar does not list Teams as an allowed provider; nothing created."
            destroy loo_Token
            destroy loo_Http
            destroy loo_Resp
            destroy loo_Result
            destroy loo_Fac
            destroy loo_Body
            return
        end if

        loo_Body.UpdateBool("isOnlineMeeting",1)
        loo_Body.UpdateString("onlineMeetingProvider","teamsForBusiness")
    end if

    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 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.AddDays(1)
    if li_Success <> 1 then
        Write-Debug "Could not calculate tomorrow."
        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 meeting")
    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 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("attendees[0].emailAddress.address","attendee@example.com")
    loo_Body.UpdateString("attendees[0].type","required")
    loo_Body.UpdateBool("responseRequested",1)
    //  Adding attendees sends real invitations. Replace the sample address before running.
    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."
if loo_Result.JsonTypeOf("onlineMeeting.joinUrl") = 1 then
    Write-Debug "Meeting join URL: " + loo_Result.StringOf("onlineMeeting.joinUrl")
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
destroy loo_Saved