GrooveContacts.Create Operation

The Create operation adds a new contact to the personal contact list.


The HTTP Post URL targets the service for the account. This URI is returned by the GrooveAccounts.Read2 operation in the Contacts parameter.

Input Message Header

GrooveRequestHeader specifies information common to all Groove Web Services, including the Groove Identity URL and the Groove Request key.

Input Message Parameters

  <!-- Array of -->  <URI />
Element Data type Description


Array of xs:anyURI

Identity URLs of the contacts to add to the list.

Output Message Header

GrooveResponseHeader specifies the Response key.

Return Value



In order to add a contact to the personal contact list, Groove requires information about that contact. Groove has this required information if any of the following are true:

  • Contact is in a workspace with the current user.

  • Contact has sent the current user a Groove message and the user has retained the message in the message store.

  • Contact has been successfully fetched with the GrooveContacts.Fetch operation.

If the ContactURIList contains an Identity URL and Groove does not have access to the information about that contact, then the operation fails.

See Also


GrooveContacts Web Service