Jump to: navigation, search

Send Email


This operation sends an e-mail interaction.

URI HTTP Method HTTP Header Value
/api/v2/emails POST Content-Type multipart/form-data


Parameter Name Sample Value Description Required/Optional
firstName "John" The first name of the customer. Required
lastName "Doe" The last name of the customer. Required
tenantName "Environment" The tenant name. Required
fromAddress "jdoe@gmail.com" The e-mail address of the customer. Required
subject "Help with account" The subject line of the e-mail interaction. Required
text "I need help with my account" The body of the e-mail interaction. Required
mailbox support@company.com The address to which the e-mail interaction is to be delivered.
This value takes priority over any configured mailbox in WebAPI application on the Configuration Server
userData key1=value1 user data—can be submitted multiple times Optional
userData key2=value2 user data—can be submitted multiple times Optional
files Any files to be attached to the e-mail interaction. Optional


Constraints Default Value Configuration Parameter Comments
Max no. of files 10 Options / email / max_files
Max size of content 10MB Options / email / max_size
File Types
  • pdf
  • doc
  • txt
  • jpg
  • png
  • gif
  • bmp
  • zip
Options / email / file_types If the parameter file_types is configured, it overrides the default value.

Other configurations

Configuration Parameter Comments
Options / email / mailbox The address to which the email is to be delivered.

If no value is set in the incoming request and this value is set on the Configuration Server, the Configuration Server value will be set as the mailbox in the request to the EmailServer. If neither of these values are set, the EmailServer sets it using EmailServer defaults.



Content-Type: multipart/form-data; boundary="WebKitFormBoundaryE19zNvXGzXaLvS5C"
Content-Disposition: form-data; name="firstName"
Content-Disposition: form-data; name="lastName"
Content-Disposition: form-data; name="fromAddress"
Content-Disposition: form-data; name="subject"
Hi hello
Content-Disposition: form-data; name="text"
This is the text
Content-Disposition: form-data; name="tenantName"


HTTP 200 - success
This page was last edited on March 27, 2015, at 19:35.
Comments or questions about this documentation? Contact us for support!