Outlook Calendar: Delete an Event
See more Outlook Calendar Examples
Delete one event by its opaque Graph ID. Requires delegated Calendars.ReadWrite. Replace YOUR_EVENT_ID with the ID returned by the create/list example, preserving case; the code encodes it as a single URL path segment. An iCalUId, subject, or calendar ID cannot replace an event ID.
Live deletion: deleting a meeting from its organizer's calendar sends cancellations to attendees. Deleting a recurring-series master removes the series; use an occurrence ID only when you intend to delete that occurrence. To decline an invitation or send a cancellation with a comment, use the corresponding event action instead of treating every workflow as DELETE.
A successful response is 204 No Content, so there is no JSON to parse. A 404 can reflect an absent event, an incorrect ID, or the wrong mailbox/context; the example does not report it as a confirmed deletion. The immutable-ID preference matches the revised create/list examples. Use the ID format consistently when integrating existing records.
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 Unicode C++ Downloads
#include <CkJsonObjectW.h>
#include <CkHttpW.h>
#include <CkHttpResponseW.h>
#include <CkStringBuilderW.h>
void ChilkatSample(void)
{
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.
CkJsonObjectW token;
token.put_Strict(true);
success = token.LoadFile(L"qa_data/tokens/outlookCalendar.json");
if (success != true) {
wprintf(L"Could not read the private calendar token cache.\n");
return;
}
if ((token.JsonTypeOf(L"access_token") != 1) || (token.StringOfEquals(L"access_token",L"",true) == true)) {
wprintf(L"Expected a nonempty access_token in the JSON.\n");
return;
}
CkHttpW http;
http.put_AuthToken(token.stringOf(L"access_token"));
http.put_RequireSslCertVerify(true);
http.put_FollowRedirects(false);
http.put_ConnectTimeout(20);
http.put_ReadTimeout(30);
http.SetRequestHeader(L"Accept",L"application/json");
CkHttpResponseW resp;
CkJsonObjectW result;
result.put_Strict(true);
http.SetRequestHeader(L"Prefer",L"outlook.timezone=\"UTC\", IdType=\"ImmutableId\"");
// Live deletion. Use the exact event ID returned by a previous Graph request.
// Deleting an organizer's meeting sends cancellation messages to attendees.
const wchar_t *eventId = L"YOUR_EVENT_ID";
CkStringBuilderW url;
url.Append(L"https://graph.microsoft.com/v1.0/me/events/");
url.Append(http.urlEncode(eventId));
success = http.HttpNoBody(L"DELETE",url.getAsString(),resp);
// A false result can still include an HTTP error response.
if ((success != true) && (resp.get_StatusCode() == 0)) {
wprintf(L"No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.\n");
return;
}
if (resp.get_StatusCode() != 204) {
wprintf(L"Unexpected HTTP status: %d\n",resp.get_StatusCode());
wprintf(L"Request ID: %s\n",resp.getHeaderField(L"request-id"));
if (resp.get_StatusCode() == 429) {
wprintf(L"Retry-After: %s\n",resp.getHeaderField(L"Retry-After"));
}
if (resp.get_StatusCode() == 401) {
wprintf(L"Refresh the Graph access token or authorize again.\n");
}
return;
}
// HTTP 204 has no JSON body.
wprintf(L"Event deleted.\n");
}