GrooveMessages.CreateForward Operation

The CreateForward operation forwards a message, including any attachments, to recipients specified in a message header. You can optionally add additional content and attachments to the forwarded message.


The HTTP Post URL targets the message to be forwarded. This URI is returned by the Read operation and other operations.

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

    <AdditionalHeaderData />
    <AdditionalContent />
Element Data type Description



Provides the recipients for the forwarded message.



Provides additional content to be included with the content of the original message.

Output Message Header

GrooveResponseHeader specifies the Response key.

Return Value

<CreateForwardResult />
Element Data type Description



A URI identifying the sent message.


Additional content may be prepended to the message and attachments may be added to the message by specifying them in the AdditionalContent input parameter. The URI of the resulting forwarded message is returned.

If the original message that is being forwarded has a voice memo, the voice memo is converted to a file attachment. A title is generated for the attachment of the form "Voice memo from original-sender". The attachment type is set to File.

You specify a recipient of the forwarded message with the Groove Identity URL of the contact in a MessageContact in the Recipients element of the AdditionalHeaderDataMessageHeader.

You can send messages only to contacts that are accessible to the account. The following kinds of contacts are accessible:

  • Contacts in the account Contact list.

  • Members of workspaces that the account belongs to.

  • Contacts who have been the sender or a recipient of a message in the account message history.

If a call to the Create, CreateForward, or CreateReply operation specifies a recipient that is not accessible to the account, a SOAP fault will be returned and the entire operation will fail. The SOAP exception does not provide any information on which contact caused the operation to fail.

See Also


GrooveMessages Web Service
GrooveMessages.Create Operation
GrooveMessages.CreateReply Operation


Accessing Groove Messages