CreateItem (Calendar Item)
Last modified: March 16, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
The CreateItem operation creates calendar items in the Exchange store.
Remarks
The CreateItem operation creates appointments, meetings, and meeting requests. If a calendar item is created without attendees, it is considered an appointment. If attendees are specified, the calendar item is a meeting. When a meeting is created by using the CreateItem operation, meeting requests are automatically sent to the identified attendees if the SendMeetingInvitations attribute is set to send the meeting requests.
CreateItem (Calendar Item) Request Example
Description
The following example of a CreateItem request shows how to create a meeting with two required attendees. This request will send the meeting requests to the two attendees.
Code
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
SendMeetingInvitations="SendToAllAndSaveCopy" >
<SavedItemFolderId>
<t:DistinguishedFolderId Id="calendar"/>
</SavedItemFolderId>
<Items>
<t:CalendarItem xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<Subject>Planning Meeting</Subject>
<Body BodyType="Text">Plan the agenda for next week's meeting.</Body>
<ReminderIsSet>true</ReminderIsSet>
<ReminderMinutesBeforeStart>60</ReminderMinutesBeforeStart>
<Start>2006-11-02T14:00:00</Start>
<End>2006-11-02T15:00:00</End>
<IsAllDayEvent>false</IsAllDayEvent>
<LegacyFreeBusyStatus>Busy</LegacyFreeBusyStatus>
<Location>Conference Room 721</Location>
<RequiredAttendees>
<Attendee>
<Mailbox>
<EmailAddress>User1@example.com</EmailAddress>
</Mailbox>
</Attendee>
<Attendee>
<Mailbox>
<EmailAddress>User2@example.com</EmailAddress>
</Mailbox>
</Attendee>
</RequiredAttendees>
</t:CalendarItem>
</Items>
</CreateItem>
</soap:Body>
</soap:Envelope>
Comments
For an example of how to respond to a meeting request, see the CreateItem (Meeting Request) topic.
Request Elements
The following elements are used in the request:
Successful CreateItem (Calendar Item) Response
Description
The following example shows a successful response to the CreateItem request.
Code
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="685" MinorBuildNumber="8"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<CreateItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:CreateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAAlAFV" ChangeKey="DwAAABYA" />
</t:CalendarItem>
</m:Items>
</m:CreateItemResponseMessage>
</m:ResponseMessages>
</CreateItemResponse>
</soap:Body>
</soap:Envelope>
Comments
The ItemId element Id and ChangeKey attributes have been shortened to preserve readability.
Successful Response Elements
The following elements are used in the response: