GrooveContacts.Create Operation

Applies to: SharePoint Workspace 2010 | Visual Studio 2008

In this article
HTTP Post URL
Input Message Header
Input Message Parameters
Output Message Header
Return Value

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

HTTP Post URL

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

<ContactURIList>
  <!-- Array of -->  <URI />
</ContactURIList>

Element

Data type

Description

ContactURIList

Array of xs:anyURI

Identity URLs of the contacts to add to the list.

Output Message Header

GrooveResponseHeader specifies the Response key.

Return Value

None.

Remarks

To add a contact to the personal contact list, SharePoint Workspace requires information about that contact. SharePoint Workspace 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 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 SharePoint Workspace does not have access to the information about that contact, then the operation fails.

See Also

Reference

GrooveContacts Web Service