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.
Chilkat PHP ActiveX Downloads
<?php
$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.
$token = new COM("Chilkat.JsonObject");
$token->Strict = 1;
$success = $token->LoadFile('qa_data/tokens/outlookCalendar.json');
if ($success != 1) {
print 'Could not read the private calendar token cache.' . "\n";
exit;
}
if (($token->JsonTypeOf('access_token') != 1) or ($token->StringOfEquals('access_token','',1) == 1)) {
print 'Expected a nonempty access_token in the JSON.' . "\n";
exit;
}
$http = new COM("Chilkat.Http");
$http->AuthToken = $token->stringOf('access_token');
$http->RequireSslCertVerify = 1;
$http->FollowRedirects = 0;
$http->ConnectTimeout = 20;
$http->ReadTimeout = 30;
$http->SetRequestHeader('Accept','application/json');
$resp = new COM("Chilkat.HttpResponse");
$result = new COM("Chilkat.JsonObject");
$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.
$requestFile = 'qa_data/outlookCalendar/create-all-day-request.json';
$resultFile = 'qa_data/outlookCalendar/created-all-day.json';
$fac = new COM("Chilkat.FileAccess");
$success = $fac->DirEnsureExists('qa_data/outlookCalendar');
if ($success != 1) {
print 'Could not create the private operation directory.' . "\n";
exit;
}
$body = new COM("Chilkat.JsonObject");
$body->Strict = 1;
if ($fac->FileExists($requestFile) == 1) {
$success = $body->LoadFile($requestFile);
if ($success != 1) {
print 'Could not read the saved create request; nothing sent.' . "\n";
exit;
}
// Retry the same saved body and transactionId after an uncertain result.
}
else {
$day = new COM("Chilkat.CkDateTime");
$success = $day->SetFromCurrentSystemTime();
if ($success != 1) {
print 'Could not get the date.' . "\n";
exit;
}
$success = $day->AddDays(1);
if ($success != 1) {
print 'Could not choose the start date.' . "\n";
exit;
}
$midnight = new COM("Chilkat.StringBuilder");
$midnight->Append($day->getAsIso8601('YYYY-MM-DD',0));
$midnight->Append('T00:00:00');
$body->UpdateString('start.dateTime',$midnight->getAsString());
$body->UpdateString('start.timeZone','UTC');
$success = $day->AddDays(2);
if ($success != 1) {
print 'Could not calculate the exclusive end date.' . "\n";
exit;
}
$midnight->Clear();
$midnight->Append($day->getAsIso8601('YYYY-MM-DD',0));
$midnight->Append('T00:00:00');
$body->UpdateString('end.dateTime',$midnight->getAsString());
$body->UpdateString('end.timeZone','UTC');
$body->UpdateString('subject','All-day event');
$body->UpdateBool('isAllDay',1);
$body->UpdateString('showAs','free');
// No attendees: this is an appointment, so the request does not send invitations.
$crypt = new COM("Chilkat.Crypt2");
$transactionId = $crypt->generateUuid();
if ($crypt->LastMethodSuccess != 1) {
print 'Could not create a transaction ID.' . "\n";
exit;
}
$body->UpdateString('transactionId',$transactionId);
$success = $body->WriteFile($requestFile);
if ($success != 1) {
print 'Could not save the request before sending; nothing sent.' . "\n";
exit;
}
}
if (($body->JsonTypeOf('transactionId') != 1) or ($body->StringOfEquals('transactionId','',1) == 1)) {
print 'Expected a nonempty transactionId in the JSON.' . "\n";
exit;
}
// A previous successful run leaves a small receipt. Do not submit it again.
if ($fac->FileExists($resultFile) == 1) {
$receipt = new COM("Chilkat.JsonObject");
$receipt->Strict = 1;
$success = $receipt->LoadFile($resultFile);
if ($success != 1) {
print 'Could not read the existing receipt; nothing sent.' . "\n";
exit;
}
if (($receipt->JsonTypeOf('id') != 1) or ($receipt->StringOfEquals('id','',1) == 1)) {
print 'Expected a nonempty id in the JSON.' . "\n";
exit;
}
if ($receipt->StringOfEquals('transactionId',$body->stringOf('transactionId'),1) != 1) {
print 'The receipt belongs to another operation; nothing sent.' . "\n";
exit;
}
print 'Already created event ID: ' . $receipt->stringOf('id') . "\n";
exit;
}
$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)) {
print 'No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.' . "\n";
exit;
}
if ($resp->StatusCode != 201) {
print 'Unexpected HTTP status: ' . $resp->StatusCode . "\n";
print 'Request ID: ' . $resp->getHeaderField('request-id') . "\n";
if ($resp->StatusCode == 429) {
print 'Retry-After: ' . $resp->getHeaderField('Retry-After') . "\n";
}
if ($resp->StatusCode == 401) {
print 'Refresh the Graph access token or authorize again.' . "\n";
}
exit;
}
$success = $result->Load($resp->BodyStr);
if ($success != 1) {
print 'Expected a well-formed JSON response.' . "\n";
exit;
}
if (($result->JsonTypeOf('id') != 1) or ($result->StringOfEquals('id','',1) == 1)) {
print 'Expected a nonempty id in the JSON.' . "\n";
exit;
}
$saved = new COM("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.
print 'Created event ID: ' . $result->stringOf('id') . "\n";
$success = $saved->WriteFile($resultFile);
if ($success != 1) {
print 'The event was created, but its receipt could not be saved. Reconcile before retrying.' . "\n";
exit;
}
print 'Start: ' . $result->stringOf('start.dateTime') . ' (' . $result->stringOf('start.timeZone') . ')' . "\n";
print 'End: ' . $result->stringOf('end.dateTime') . ' (' . $result->stringOf('end.timeZone') . ')' . "\n";
print 'Event receipt saved.' . "\n";
?>