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

C#
bool 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.
Chilkat.JsonObject token = new Chilkat.JsonObject();
token.Strict = true;
success = token.LoadFile("qa_data/tokens/outlookCalendar.json");
if (success != true) {
    Debug.WriteLine("Could not read the private calendar token cache.");
    return;
}

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

Chilkat.Http http = new Chilkat.Http();
http.AuthToken = token.StringOf("access_token");
http.RequireSslCertVerify = true;
http.FollowRedirects = false;
http.ConnectTimeout = 20;
http.ReadTimeout = 30;
http.SetRequestHeader("Accept","application/json");
Chilkat.HttpResponse resp = new Chilkat.HttpResponse();
Chilkat.JsonObject result = new Chilkat.JsonObject();
result.Strict = 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.
string requestFile = "qa_data/outlookCalendar/create-meeting-request.json";
string resultFile = "qa_data/outlookCalendar/created-meeting.json";
Chilkat.FileAccess fac = new Chilkat.FileAccess();
success = fac.DirEnsureExists("qa_data/outlookCalendar");
if (success != true) {
    Debug.WriteLine("Could not create the private operation directory.");
    return;
}

//  Set true only for a Teams-enabled organizational calendar.
bool enableTeams = false;
Chilkat.JsonObject body = new Chilkat.JsonObject();
body.Strict = true;
if (fac.FileExists(requestFile) == true) {
    success = body.LoadFile(requestFile);
    if (success != true) {
        Debug.WriteLine("Could not read the saved create request; nothing sent.");
        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)) {
            Debug.WriteLine("No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.");
            return;
        }

        if (resp.StatusCode != 200) {
            Debug.WriteLine("Unexpected HTTP status: " + Convert.ToString(resp.StatusCode));
            Debug.WriteLine("Request ID: " + resp.GetHeaderField("request-id"));
            if (resp.StatusCode == 429) {
                Debug.WriteLine("Retry-After: " + resp.GetHeaderField("Retry-After"));
            }

            if (resp.StatusCode == 401) {
                Debug.WriteLine("Refresh the Graph access token or authorize again.");
            }

            return;
        }

        success = result.Load(resp.BodyStr);
        if (success != true) {
            Debug.WriteLine("Expected a well-formed JSON response.");
            return;
        }

        if (result.JsonTypeOf("allowedOnlineMeetingProviders") != 4) {
            Debug.WriteLine("Could not determine supported meeting providers.");
            return;
        }

        bool teamsAllowed = false;
        int providerIndex = 0;
        while ((providerIndex < result.SizeOfArray("allowedOnlineMeetingProviders"))) {
            result.I = providerIndex;
            if (result.StringOfEquals("allowedOnlineMeetingProviders[i]","teamsForBusiness",true) == true) {
                teamsAllowed = true;
            }

            providerIndex = providerIndex + 1;
        }

        if (teamsAllowed != true) {
            Debug.WriteLine("This calendar does not list Teams as an allowed provider; nothing created.");
            return;
        }

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

    Chilkat.CkDateTime when = new Chilkat.CkDateTime();
    success = when.SetFromCurrentSystemTime();
    if (success != true) {
        Debug.WriteLine("Could not get the time.");
        return;
    }

    success = when.AddDays(1);
    if (success != true) {
        Debug.WriteLine("Could not calculate tomorrow.");
        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) {
        Debug.WriteLine("Could not calculate the end.");
        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.
    Chilkat.Crypt2 crypt = new Chilkat.Crypt2();
    string transactionId = crypt.GenerateUuid();
    if (crypt.LastMethodSuccess != true) {
        Debug.WriteLine("Could not create a transaction ID.");
        return;
    }

    body.UpdateString("transactionId",transactionId);
    success = body.WriteFile(requestFile);
    if (success != true) {
        Debug.WriteLine("Could not save the request before sending; nothing sent.");
        return;
    }

}

if ((body.JsonTypeOf("transactionId") != 1) || (body.StringOfEquals("transactionId","",true) == true)) {
    Debug.WriteLine("Expected a nonempty transactionId in the JSON.");
    return;
}

//  A previous successful run leaves a small receipt. Do not submit it again.
if (fac.FileExists(resultFile) == true) {
    Chilkat.JsonObject receipt = new Chilkat.JsonObject();
    receipt.Strict = true;
    success = receipt.LoadFile(resultFile);
    if (success != true) {
        Debug.WriteLine("Could not read the existing receipt; nothing sent.");
        return;
    }

    if ((receipt.JsonTypeOf("id") != 1) || (receipt.StringOfEquals("id","",true) == true)) {
        Debug.WriteLine("Expected a nonempty id in the JSON.");
        return;
    }

    if (receipt.StringOfEquals("transactionId",body.StringOf("transactionId"),true) != true) {
        Debug.WriteLine("The receipt belongs to another operation; nothing sent.");
        return;
    }

    Debug.WriteLine("Already created event ID: " + receipt.StringOf("id"));
    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)) {
    Debug.WriteLine("No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.");
    return;
}

if (resp.StatusCode != 201) {
    Debug.WriteLine("Unexpected HTTP status: " + Convert.ToString(resp.StatusCode));
    Debug.WriteLine("Request ID: " + resp.GetHeaderField("request-id"));
    if (resp.StatusCode == 429) {
        Debug.WriteLine("Retry-After: " + resp.GetHeaderField("Retry-After"));
    }

    if (resp.StatusCode == 401) {
        Debug.WriteLine("Refresh the Graph access token or authorize again.");
    }

    return;
}

success = result.Load(resp.BodyStr);
if (success != true) {
    Debug.WriteLine("Expected a well-formed JSON response.");
    return;
}

if ((result.JsonTypeOf("id") != 1) || (result.StringOfEquals("id","",true) == true)) {
    Debug.WriteLine("Expected a nonempty id in the JSON.");
    return;
}

Chilkat.JsonObject saved = new Chilkat.JsonObject();
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.
Debug.WriteLine("Created event ID: " + result.StringOf("id"));
success = saved.WriteFile(resultFile);
if (success != true) {
    Debug.WriteLine("The event was created, but its receipt could not be saved. Reconcile before retrying.");
    return;
}

Debug.WriteLine("Start: " + result.StringOf("start.dateTime") + " (" + result.StringOf("start.timeZone") + ")");
Debug.WriteLine("End: " + result.StringOf("end.dateTime") + " (" + result.StringOf("end.timeZone") + ")");
Debug.WriteLine("Event receipt saved.");
if (result.JsonTypeOf("onlineMeeting.joinUrl") == 1) {
    Debug.WriteLine("Meeting join URL: " + result.StringOf("onlineMeeting.joinUrl"));
}