digitaluapi

<back to all web services

SendMailRequest

Requires Authentication
Requires any of the roles:Client, Admin, Partner
The following routes are available for this service:
POST/communication/sendmailSends an email
Imports System
Imports System.IO
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports digitaluapi.ServiceModel

Namespace Global

    Namespace digitaluapi.ServiceModel

        Public Partial Class Attachment
            Public Overridable Property Content As String
            Public Overridable Property Type As String
            Public Overridable Property Filename As String
            Public Overridable Property Disposition As String
            Public Overridable Property ContentId As String
        End Class

        Public Partial Class AttachmentStream
            Public Overridable Property Stream As Stream
            Public Overridable Property Name As String
            Public Overridable Property Type As String
            Public Overridable Property Disposition As String
            Public Overridable Property Contentid As String
        End Class

        Public Partial Class SendMailRequest
            '''<Summary>
            '''Email address of sender. If it is not set the a default address will be used.
            '''</Summary>
            <ApiMember(Description:="Email address of sender. If it is not set the a default address will be used.")>
            Public Overridable Property FromAddress As String

            '''<Summary>
            '''List of recipient email addresses
            '''</Summary>
            <ApiMember(Description:="List of recipient email addresses", IsRequired:=true)>
            Public Overridable Property Recipients As IEnumerable(Of String)

            '''<Summary>
            '''Email subject
            '''</Summary>
            <ApiMember(Description:="Email subject", IsRequired:=true)>
            Public Overridable Property Subject As String

            '''<Summary>
            '''Plain text body. Either this or HtmlBody is required
            '''</Summary>
            <ApiMember(Description:="Plain text body. Either this or HtmlBody is required")>
            Public Overridable Property Body As String

            '''<Summary>
            '''Html body. Either this or Body is required
            '''</Summary>
            <ApiMember(Description:="Html body. Either this or Body is required")>
            Public Overridable Property HtmlBody As String

            '''<Summary>
            '''Email attachments
            '''</Summary>
            <ApiMember(Description:="Email attachments")>
            Public Overridable Property Attachments As String()

            '''<Summary>
            '''Email attachments
            '''</Summary>
            <ApiMember(Description:="Email attachments")>
            Public Overridable Property AttachmentsObject As Attachment()

            '''<Summary>
            '''Attachment streams
            '''</Summary>
            <ApiMember(Description:="Attachment streams")>
            Public Overridable Property AttachmentStreams As AttachmentStream()

            '''<Summary>
            '''Template substitutions
            '''</Summary>
            <ApiMember(Description:="Template substitutions")>
            Public Overridable Property TemplateSubstitutions As Dictionary(Of String, String)

            '''<Summary>
            '''Template Id
            '''</Summary>
            <ApiMember(Description:="Template Id")>
            Public Overridable Property TemplateId As String

            '''<Summary>
            '''List of BCC email addresses
            '''</Summary>
            <ApiMember(Description:="List of BCC email addresses")>
            Public Overridable Property Bcc As IEnumerable(Of String)

            '''<Summary>
            '''List of CC email addresses
            '''</Summary>
            <ApiMember(Description:="List of CC email addresses")>
            Public Overridable Property Cc As IEnumerable(Of String)
        End Class
    End Namespace
End Namespace

VB.NET SendMailRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /communication/sendmail HTTP/1.1 
Host: duengageapi.uat.scadsoftware.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<SendMailRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/digitaluapi.ServiceModel">
  <AttachmentStreams>
    <AttachmentStream>
      <Contentid>String</Contentid>
      <Disposition>String</Disposition>
      <Name>String</Name>
      <Stream xmlns:d4p1="http://schemas.datacontract.org/2004/07/System.IO" i:nil="true" />
      <Type>String</Type>
    </AttachmentStream>
  </AttachmentStreams>
  <Attachments xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </Attachments>
  <AttachmentsObject>
    <Attachment>
      <Content>String</Content>
      <ContentId>String</ContentId>
      <Disposition>String</Disposition>
      <Filename>String</Filename>
      <Type>String</Type>
    </Attachment>
  </AttachmentsObject>
  <Bcc xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
  <Body>String</Body>
  <Cc xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
  <FromAddress>String</FromAddress>
  <HtmlBody>String</HtmlBody>
  <Recipients xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
  <Subject>String</Subject>
  <TemplateId>String</TemplateId>
  <TemplateSubstitutions xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringstring>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value>String</d2p1:Value>
    </d2p1:KeyValueOfstringstring>
  </TemplateSubstitutions>
</SendMailRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<z:anyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:z="http://schemas.microsoft.com/2003/10/Serialization/" />