createItemRequest

Creates mail, appointment, tasks, notes, and phone items in a mailbox without sending out the item to other users. If you need to send personal, posted, or distributed items, call sendItemRequest.

Request

<createItemRequest>
   <item/>
   <notification/>
</createItemRequest>

Response

<createItemResponse>
   <id/>
   <status/>
</createItemResponse>

Elements

item: Specifies the item to create.
notification: Specifies the information that is used in a shared folder or personal address book notification message.
id: On a successful response, specifies the ID of the newly created item. Recurring items return an ID for each item that was created.
code: Returns the error number related to the event. 0 indicates that the request was successful.
status: Returns the success or failure of the method.

Remarks

The createItemRequest method is used to create the following item types:

Address Book Items:
- Contacts
- Groups
- Organizations
- Personal Address Books
- Resources
Categories
Folders
Rules
Shared Folders
Mail Items
- Mail Messages
- Appointments
- Tasks
- Notes
- Phone Messages

Example

<createItemRequest>
   <item types="Contact">
   <container>406901A0.provo.research.104.16C3230.1.3.1@53</container> 
   <categories types:primary="1.provo.research.100.0.1.0.1@61"
      <category>4.provo.research.100.0.1.0.1@61</category>
      <category>1.provo.research.100.0.1.0.1@61</category>
   </categories>
   <fullName>
      <displayName>John Doe</displayName>

      <firstName>John</firstName>
      <lastName>Doe</lastName> 
   </fullName> 
   <emailList primary="jdoe@novell.com"
      <email>jdoe@novell.com</email> 
   </emailList> 
   <email>jdoe@novell.com</email>
   </types:item>
</createItemRequest>

<createItemResponse>
   <id>407D48DF.provo.research.104.16C3230.1.7D.1@56</id>
   <status>
      <code>0</code>
   </status>
</createItemResponse>