The Email service has one public URL. (For information about the difference between Public and Internal URLs and HATEOAS conventions, please see API Structure and Conventions.)
Sends an email. The email will always contain both an HTML and a plaintext version.
The body of the POST can contain the following attributes:
- (String) The email address of the sender. Defaults to "Noreply <email@example.com>".
- (String) The email address of the recipient. Must be specified.
- (String) The subject of the email. Must be specified.
- (String) The plain text version of the message. If not given, a plaintext version of the html attribute will be used.
- (String) The HTML version of the message. If not given, the plaintext attribute will be treated as Markdown and translated into HTML.
- (String) If present, a URI of a Text resource to be used for the plaintext version of the message.
- (String) If present, a URI of a Text resource to be used for the HTML version of the message.
- (Object) If present, a hash table of text substitutions to be performed on both plaintext and HTML versions.
An AsyncJob is returned. In most cases you will probably just ignore it, but it is possible to perform CRUD operations on it to delete it and/or poll it for changes.