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.
HTTP Post URL
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
<CreateForward> <AdditionalHeaderData /> <AdditionalContent /> </CreateForward>
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.
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 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.