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

Go
    success := false

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false
    //  Obtain a delegated Microsoft Graph token using the calendar authorization example.
    //  See Authorize Outlook Calendar with OAuth2 and PKCE.
    token := chilkat.NewJsonObject()
    token.SetStrict(true)
    success = token.LoadFile("qa_data/tokens/outlookCalendar.json")
    if success != true {
        fmt.Println("Could not read the private calendar token cache.")
        token.DisposeJsonObject()
        return
    }

    if (token.JsonTypeOf("access_token") != 1) || (token.StringOfEquals("access_token","",true) == true) {
        fmt.Println("Expected a nonempty access_token in the JSON.")
        token.DisposeJsonObject()
        return
    }

    http := chilkat.NewHttp()
    http.SetAuthToken(token.StringOf("access_token"))
    http.SetRequireSslCertVerify(true)
    http.SetFollowRedirects(false)
    http.SetConnectTimeout(20)
    http.SetReadTimeout(30)
    http.SetRequestHeader("Accept","application/json")
    resp := chilkat.NewHttpResponse()
    result := chilkat.NewJsonObject()
    result.SetStrict(true)
    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.
    requestFile := "qa_data/outlookCalendar/create-meeting-request.json"
    resultFile := "qa_data/outlookCalendar/created-meeting.json"
    fac := chilkat.NewFileAccess()
    success = fac.DirEnsureExists("qa_data/outlookCalendar")
    if success != true {
        fmt.Println("Could not create the private operation directory.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        return
    }

    //  Set true only for a Teams-enabled organizational calendar.
    enableTeams := false
    body := chilkat.NewJsonObject()
    body.SetStrict(true)
    if fac.FileExists(requestFile) == true {
        success = body.LoadFile(requestFile)
        if success != true {
            fmt.Println("Could not read the saved create request; nothing sent.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            return
        }

        //  Retry the same saved body and transactionId after an uncertain result.
    } else {
        if enableTeams == true {
            success = http.HttpNoBody("GET","https://graph.microsoft.com/v1.0/me/calendar?$select=allowedOnlineMeetingProviders",resp)
            //  A false result can still include an HTTP error response.
            if (success != true) && (resp.StatusCode() == 0) {
                fmt.Println("No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.")
                token.DisposeJsonObject()
                http.DisposeHttp()
                resp.DisposeHttpResponse()
                result.DisposeJsonObject()
                fac.DisposeFileAccess()
                body.DisposeJsonObject()
                return
            }

            if resp.StatusCode() != 200 {
                fmt.Println("Unexpected HTTP status: ", resp.StatusCode())
                fmt.Println("Request ID: ", *resp.GetHeaderField("request-id"))
                if resp.StatusCode() == 429 {
                    fmt.Println("Retry-After: ", *resp.GetHeaderField("Retry-After"))
                }

                if resp.StatusCode() == 401 {
                    fmt.Println("Refresh the Graph access token or authorize again.")
                }

                token.DisposeJsonObject()
                http.DisposeHttp()
                resp.DisposeHttpResponse()
                result.DisposeJsonObject()
                fac.DisposeFileAccess()
                body.DisposeJsonObject()
                return
            }

            success = result.Load(resp.BodyStr())
            if success != true {
                fmt.Println("Expected a well-formed JSON response.")
                token.DisposeJsonObject()
                http.DisposeHttp()
                resp.DisposeHttpResponse()
                result.DisposeJsonObject()
                fac.DisposeFileAccess()
                body.DisposeJsonObject()
                return
            }

            if result.JsonTypeOf("allowedOnlineMeetingProviders") != 4 {
                fmt.Println("Could not determine supported meeting providers.")
                token.DisposeJsonObject()
                http.DisposeHttp()
                resp.DisposeHttpResponse()
                result.DisposeJsonObject()
                fac.DisposeFileAccess()
                body.DisposeJsonObject()
                return
            }

            teamsAllowed := false
            providerIndex := 0
            for (providerIndex < result.SizeOfArray("allowedOnlineMeetingProviders")) {
                result.SetI(providerIndex)
                if result.StringOfEquals("allowedOnlineMeetingProviders[i]","teamsForBusiness",true) == true {
                    teamsAllowed = true
                }

                providerIndex = providerIndex + 1
            }

            if teamsAllowed != true {
                fmt.Println("This calendar does not list Teams as an allowed provider; nothing created.")
                token.DisposeJsonObject()
                http.DisposeHttp()
                resp.DisposeHttpResponse()
                result.DisposeJsonObject()
                fac.DisposeFileAccess()
                body.DisposeJsonObject()
                return
            }

            body.UpdateBool("isOnlineMeeting",true)
            body.UpdateString("onlineMeetingProvider","teamsForBusiness")
        }

        when := chilkat.NewCkDateTime()
        success = when.SetFromCurrentSystemTime()
        if success != true {
            fmt.Println("Could not get the time.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            return
        }

        success = when.AddDays(1)
        if success != true {
            fmt.Println("Could not calculate tomorrow.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            return
        }

        body.UpdateString("subject","Sample meeting")
        body.UpdateString("body.contentType","text")
        body.UpdateString("body.content","Sample event details.")
        body.UpdateString("start.dateTime",*when.GetAsIso8601("YYYY-MM-DDThh:mm:ss",false))
        body.UpdateString("start.timeZone","UTC")
        success = when.AddSeconds(3600)
        if success != true {
            fmt.Println("Could not calculate the end.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            return
        }

        body.UpdateString("end.dateTime",*when.GetAsIso8601("YYYY-MM-DDThh:mm:ss",false))
        body.UpdateString("end.timeZone","UTC")
        body.UpdateString("attendees[0].emailAddress.address","attendee@example.com")
        body.UpdateString("attendees[0].type","required")
        body.UpdateBool("responseRequested",true)
        //  Adding attendees sends real invitations. Replace the sample address before running.
        crypt := chilkat.NewCrypt2()
        transactionId := crypt.GenerateUuid()
        if crypt.LastMethodSuccess() != true {
            fmt.Println("Could not create a transaction ID.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            crypt.DisposeCrypt2()
            return
        }

        body.UpdateString("transactionId",*transactionId)
        success = body.WriteFile(requestFile)
        if success != true {
            fmt.Println("Could not save the request before sending; nothing sent.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            crypt.DisposeCrypt2()
            return
        }

    }

    if (body.JsonTypeOf("transactionId") != 1) || (body.StringOfEquals("transactionId","",true) == true) {
        fmt.Println("Expected a nonempty transactionId in the JSON.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        body.DisposeJsonObject()
        when.DisposeCkDateTime()
        crypt.DisposeCrypt2()
        return
    }

    //  A previous successful run leaves a small receipt. Do not submit it again.
    if fac.FileExists(resultFile) == true {
        receipt := chilkat.NewJsonObject()
        receipt.SetStrict(true)
        success = receipt.LoadFile(resultFile)
        if success != true {
            fmt.Println("Could not read the existing receipt; nothing sent.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            crypt.DisposeCrypt2()
            receipt.DisposeJsonObject()
            return
        }

        if (receipt.JsonTypeOf("id") != 1) || (receipt.StringOfEquals("id","",true) == true) {
            fmt.Println("Expected a nonempty id in the JSON.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            crypt.DisposeCrypt2()
            receipt.DisposeJsonObject()
            return
        }

        if receipt.StringOfEquals("transactionId",*body.StringOf("transactionId"),true) != true {
            fmt.Println("The receipt belongs to another operation; nothing sent.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            fac.DisposeFileAccess()
            body.DisposeJsonObject()
            when.DisposeCkDateTime()
            crypt.DisposeCrypt2()
            receipt.DisposeJsonObject()
            return
        }

        fmt.Println("Already created event ID: ", *receipt.StringOf("id"))
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        body.DisposeJsonObject()
        when.DisposeCkDateTime()
        crypt.DisposeCrypt2()
        receipt.DisposeJsonObject()
        return
    }

    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 != true) && (resp.StatusCode() == 0) {
        fmt.Println("No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        body.DisposeJsonObject()
        when.DisposeCkDateTime()
        crypt.DisposeCrypt2()
        receipt.DisposeJsonObject()
        return
    }

    if resp.StatusCode() != 201 {
        fmt.Println("Unexpected HTTP status: ", resp.StatusCode())
        fmt.Println("Request ID: ", *resp.GetHeaderField("request-id"))
        if resp.StatusCode() == 429 {
            fmt.Println("Retry-After: ", *resp.GetHeaderField("Retry-After"))
        }

        if resp.StatusCode() == 401 {
            fmt.Println("Refresh the Graph access token or authorize again.")
        }

        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        body.DisposeJsonObject()
        when.DisposeCkDateTime()
        crypt.DisposeCrypt2()
        receipt.DisposeJsonObject()
        return
    }

    success = result.Load(resp.BodyStr())
    if success != true {
        fmt.Println("Expected a well-formed JSON response.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        body.DisposeJsonObject()
        when.DisposeCkDateTime()
        crypt.DisposeCrypt2()
        receipt.DisposeJsonObject()
        return
    }

    if (result.JsonTypeOf("id") != 1) || (result.StringOfEquals("id","",true) == true) {
        fmt.Println("Expected a nonempty id in the JSON.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        body.DisposeJsonObject()
        when.DisposeCkDateTime()
        crypt.DisposeCrypt2()
        receipt.DisposeJsonObject()
        return
    }

    saved := chilkat.NewJsonObject()
    saved.UpdateString("id",*result.StringOf("id"))
    saved.UpdateString("transactionId",*body.StringOf("transactionId"))
    //  Display the ID even if saving the receipt fails: the server has already created the event.
    fmt.Println("Created event ID: ", *result.StringOf("id"))
    success = saved.WriteFile(resultFile)
    if success != true {
        fmt.Println("The event was created, but its receipt could not be saved. Reconcile before retrying.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        fac.DisposeFileAccess()
        body.DisposeJsonObject()
        when.DisposeCkDateTime()
        crypt.DisposeCrypt2()
        receipt.DisposeJsonObject()
        saved.DisposeJsonObject()
        return
    }

    fmt.Println("Start: ", *result.StringOf("start.dateTime"), " (", *result.StringOf("start.timeZone"), ")")
    fmt.Println("End: ", *result.StringOf("end.dateTime"), " (", *result.StringOf("end.timeZone"), ")")
    fmt.Println("Event receipt saved.")
    if result.JsonTypeOf("onlineMeeting.joinUrl") == 1 {
        fmt.Println("Meeting join URL: ", *result.StringOf("onlineMeeting.joinUrl"))
    }


    token.DisposeJsonObject()
    http.DisposeHttp()
    resp.DisposeHttpResponse()
    result.DisposeJsonObject()
    fac.DisposeFileAccess()
    body.DisposeJsonObject()
    when.DisposeCkDateTime()
    crypt.DisposeCrypt2()
    receipt.DisposeJsonObject()
    saved.DisposeJsonObject()