Contact

The Contact element represents a contact item in the Exchange store.

<Contact>
   <MimeContent/>
   <ItemId/>
   <ParentFolderId/>
   <ItemClass/>
   <Subject/>
   <Sensitivity/>
   <Body/>
   <Attachments/>
   <DateTimeReceived/>
   <Size/>
   <Categories/>
   <Importance/>
   <InReplyTo/>
   <IsSubmitted/>
   <IsDraft/>
   <IsFromMe/>
   <IsResend/>
   <IsUnmodified/>
   <InternetMessageHeaders/>
   <DateTimeSent/>
   <DateTimeCreated/>
   <ResponseObjects/>
   <ReminderDueBy/>
   <ReminderIsSet/>
   <ReminderMinutesBeforeStart/>
   <DisplayCc/>
   <DisplayTo/>
   <HasAttachments/>
   <ExtendedProperty/>
   <Culture/>
   <EffectiveRights/>
   <LastModifiedName/>
   <LastModifiedTime/>
   <IsAssociated/>
   <WebClientReadFormQueryString/>
   <WebClientEditFormQueryString/>
   <ConversationId/>
   <UniqueBody/>
   <FileAs/>
   <FileAsMapping/>
   <DisplayName/>
   <GivenName/>
   <Initials/>
   <MiddleName/>
   <Nickname/>
   <CompleteName/>
   <CompanyName/>
   <EmailAddresses/>
   <PhysicalAddresses/>
   <PhoneNumbers/>
   <AssistantName/>
   <Birthday/>
   <BusinessHomePage/>
   <Children/>
   <Companies/>
   <ContactSource/>
   <Department/>
   <Generation/>
   <ImAddresses/>
   <JobTitle/>
   <Manager/>
   <Mileage/>
   <OfficeLocation/>
   <PostalAddressIndex/>
   <Profession/>
   <SpouseName/>
   <Surname/>
   <WeddingAnniversary/>
   <HasPicture/>
   <PhoneticFullName/>
   <PhoneticFirstName/>
   <PhoneticLastName/>
   <Alias/>
   <Notes/>
   <Photo/>
   <UserSMIMECertificate/>
   <MSExchangeCertificate/>
   <DirectoryId/>
   <ManagerMailbox/>
   <DirectReports/>
</Contact>

ContactItemType

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child elements

Element name Description
MimeContent
Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in base64Binary format.
ItemId
Contains the unique identifier and change key of an item in the Exchange store.
ParentFolderId
Represents the identifier of the parent folder that contains the item or folder.
ItemClass
Represents the message class of an item.
Subject
Represents the subject for Exchange store items and response objects.
Sensitivity
Indicates the sensitivity level of an item.
Body
Represents the actual body content of a message.
Attachments
Contains the items or files that are attached to an item in the Exchange store.
DateTimeReceived
Represents the date and time that an item in a mailbox was received.
Size
Represents the size in bytes of an item. This property is read-only.
Categories
Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance
Describes the importance of an item.
InReplyTo
Represents the identifier of the item to which this item is a reply.
IsSubmitted
Indicates whether an item has been submitted to the Outbox default folder.
IsDraft
Represents whether an item has not yet been sent.
IsFromMe
Indicates whether a user sent an item to himself or herself.
IsResend
Indicates whether the item had previously been sent.
IsUnmodified
Indicates whether the item has been modified.
InternetMessageHeaders
Represents the collection of all Internet message headers that are contained in an item in a mailbox.
DateTimeSent
Represents the date and time that an item in a mailbox was sent.
DateTimeCreated
Represents the date and time that a given item in the mailbox was created.
ResponseObjects
Contains a collection of all the response objects that are associated with an item in the Exchange store.
ReminderDueBy
Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet
Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart
Represents the number of minutes before an event when a reminder is displayed.
DisplayCc
Represents the display string that is used for the contents of the Cc line. This is the concatenated string of all Cc recipient display names.
DisplayTo
Represents the display string that is used for the contents of the To line. This is the concatenated string of all To recipient display names.
HasAttachments
Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
ExtendedProperty
Identifies extended properties on folders and items.
Culture
Represents the culture for a given item in a mailbox.
EffectiveRights
Contains the client's rights based on the permission settings for the item or folder. This element is read-only.
LastModifiedName
Contains the display name of the last user to modify an item.
LastModifiedTime
Indicates when an item was last modified.
IsAssociated
Indicates whether the item is associated with a folder.
WebClientReadFormQueryString
Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString
Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId
Contains the identifier of an item or conversation.
UniqueBody
Represents an HTML fragment or plain text which represents the unique body of this conversation.
FileAs
Represents how a contact is filed in the Contacts folder.
FileAsMapping
Defines how to construct what is displayed for a contact.
DisplayName (string)
Defines the display name of a contact.
GivenName
Contains a contact's given name.
Initials
Represents the initials of a contact.
MiddleName
Represents the middle name of a contact.
Nickname
Represents the nickname of a contact.
CompleteName
Represents the complete name of a contact.
CompanyName
Represents the company name that is associated with a contact.
EmailAddresses
Represents a collection of e-mail addresses for a contact.
PhysicalAddresses
Contains a collection of physical addresses that are associated with a contact.
PhoneNumbers
Represents a collection of telephone numbers for a contact.
AssistantName
Represents an assistant to a contact.
Birthday
Represents the birth date of a contact.
BusinessHomePage
Represents the Home page (Web address) for the contact.
Children
Contains the names of a contact's children.
Companies
Represents the collection of companies that are associated with a contact.
ContactSource
Describes whether the contact is located in the Exchange store or the Active Directory directory service.
Department
Represents the contact's department at work.
Generation
Represents a generational abbreviation that follows the full name of a contact.
ImAddresses
Represents a collection of instant messaging addresses for a contact.
JobTitle
Represents the job title of a contact.
Manager
Represents a contact's manager.
Mileage
Represents mileage for a contact item.
OfficeLocation
Represents the office location of a contact.
PostalAddressIndex
Represents the display types for physical addresses.
Profession
Represents the profession of a contact.
SpouseName
Represents the name of a contact's spouse/partner.
Surname
Represents the surname of a contact.
WeddingAnniversary
Contains the wedding anniversary of a contact.
HasPicture
Indicates whether the contact item has a file attachment that represents the contact's picture.
PhoneticFullName
Contains the full name of a contact, including the first and last name, spelled phonetically.
PhoneticFirstName
Contains the first name of a contact, spelled phonetically.
PhoneticLastName
Contains the last name of a contact, spelled phonetically.
Alias
Contains the email alias of a contact.
Notes (Contact)
Contains supplementary contact information.
Photo
Contains a value that encodes the photo of a contact.
UserSMIMECertificate
Contains a value that encodes the SMIME certificate of a contact.
MSExchangeCertificate
Contains a value that encodes the Microsoft Exchange certificate of a contact.
DirectoryId
Contains the directory ID of a contact.
ManagerMailbox
Contains SMTP information that identifies the manager mailbox of the contact.
DirectReports
Contains SMTP information that identifies the direct reports of a contact.

Parent elements

Element name Description
AdjacentMeetings
Describes all calendar items that are adjacent to a meeting time.
AppendToItemField
Identifies data to append to a single property of an item or folder during an UpdateItem operation.
ConflictingMeetings
Identifies all items that conflict with a meeting time
Create (ItemSync)
Identifies a single folder to create in the local client store.
ItemAttachment
Represents an Exchange item that is attached to another Exchange item.
Items
Contains an array of items.
Items (NonEmptyArrayOfAllItemsType)
Contains an array of items to create in the folder that is identified by the ParentFolderId (TargetFolderIdType) element.
Resolution
Contains a single resolved entity.
SetItemField
Represents an update to a single property of an item in an UpdateItem operation.
Update (ItemSync)
Identifies a single item to update in the local client store.

Text value

None.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

Element information

Element Example
Namespace
http://schemas.microsoft.com/exchange/services/2006/types
Schema name
Types schema
Validation file
Types.xsd
Can be empty
False

See also

Creating Contacts (Exchange Web Services)

Updating Contacts

Deleting Contacts