Lua

SES Send HTML Email

See more Amazon SES Examples

Sends a simple HTML email to one or more recipients.

See SES SendEmail for more information.

Lua

local chilkat = require("chilkat")

-- This example requires the Chilkat API to have been previously unlocked.
-- See Global Unlock Sample for sample code.

local rest = chilkat.Rest.new()

-- Connect to the Amazon AWS REST server.
-- such as https://email.us-west-2.amazonaws.com/
local bTls = true
local port = 443
local bAutoReconnect = true
local success = rest:connect("email.us-west-2.amazonaws.com", port, bTls, bAutoReconnect)

-- Provide AWS credentials for the REST call.
local authAws = chilkat.AuthAws.new()
authAws.access_key = "AWS_ACCESS_KEY"
authAws.secret_key = "AWS_SECRET_KEY"
-- the region should match our URL above..
authAws.region = "us-west-2"
authAws.service_name = "ses"

rest:set_auth_aws(authAws)

rest:add_query_param("Action", "SendEmail")

rest:add_query_param("Message.Body.Html.Data", "<html><body><p>This is a simple <b>HTML Email</b></p></body></html>")
rest:add_query_param("Message.Body.Html.Charset", "utf-8")

rest:add_query_param("Message.Subject.Data", "Sample HTML SES email")
rest:add_query_param("Message.Subject.Charset", "utf-8")

-- Add up to 100 TO, CC, and BCC recipients.
-- If your SES account is still in the sandbox, you also must verify every recipient email address except for the recipients
-- provided by the Amazon SES mailbox simulator. (See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/mailbox-simulator.html)
rest:add_query_param("Destination.ToAddresses.member.1", "success@simulator.amazonses.com")
-- Please do not test by sending email to Chilkat (Thank You!)
-- Please do not test by sending email to Chilkat (Thank You!)
-- Please do not test by sending email to Chilkat (Thank You!)
rest:add_query_param("Destination.CcAddresses.member.1", "support@chilkatsoft.com")
rest:add_query_param("Destination.CcAddresses.member.2", "somebody@yahoo.com")
rest:add_query_param("Destination.BccAddresses.member.1", "somebody@gmail.com")

rest:add_query_param("Source", "admin@chilkatdownload.com")

-- Because there may be a large amount of data in the query params, use a POST
-- where the params are sent in the body of the HTTP Request.
local responseXml = rest:full_request_form_url_encoded("POST", "/")
if not rest.last_method_success then
    print(rest.last_error_text)
    return
end

-- A successful response will have a status code equal to 200.
if rest.response_status_code ~= 200 then
    print("response status code = " .. rest.response_status_code)
    print("response status text = " .. rest.response_status_text)
    print("response header: " .. rest.response_header)
    print("response body: " .. responseXml)
    return
end

-- Examine the successful XML response.
local xml = chilkat.Xml.new()
xml:load_xml(responseXml)
print(xml:get_xml())

-- To get the MessageId
print("MessageId: " .. xml:chilkat_path("SendEmailResult|MessageId|*"))

-- A sample successful response:
-- <?xml version="1.0" encoding="utf-8" ?>
-- <SendEmailResponse xmlns="http://ses.amazonaws.com/doc/2010-12-01/">
--     <SendEmailResult>
--         <MessageId>010101579081d2c1-043c693f-5a23-4c64-a8c1-66187d3725a0-000000</MessageId>
--     </SendEmailResult>
--     <ResponseMetadata>
--         <RequestId>e2b5b480-8a4e-11e6-85cd-21b1f1f6d432</RequestId>
--     </ResponseMetadata>
-- </SendEmailResponse>