GrooveContacts.Create Operation

Article
10/16/2013

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

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.