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>