Lua

SendGrid Hello World -- Send Simple Email to Single Recipient

See more SendGrid Examples

Sends an email to a single recipient using SendGrid. Lua

local chilkat = require("chilkat")

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

local http = chilkat.Http.new()

-- Implements the following CURL command:

-- curl --request POST \
--   --url https://api.sendgrid.com/v3/mail/send \
--   --header 'Authorization: Bearer YOUR_API_KEY' \
--   --header 'Content-Type: application/json' \
--   --data '{"personalizations": [{"to": [{"email": "recipient@example.com", "name": "Recipient Name"}]}],"from": {"email": "sendeexampexample@example.com"},"subject": "Hello, World!","content": [{"type": "text/plain", "value": "Heya!"}]}'

-- Use the following online tool to generate HTTP code from a CURL command
-- Convert a cURL Command to HTTP Source Code

-- Use this online tool to generate code from sample JSON:
-- Generate Code to Create JSON

-- The following JSON is sent in the request body.

-- {
--   "personalizations": [
--     {
--       "to": [
--         {
--           "email": "recipient@example.com",
--           "name": "Recipient Name"
--         }
--       ]
--     }
--   ],
--   "from": {
--     "email": "sendeexampexample@example.com"
--   },
--   "subject": "Hello, World!",
--   "content": [
--     {
--       "type": "text/plain",
--       "value": "Heya!"
--     }
--   ]
-- }

local json = chilkat.JsonObject.new()
json:update_string("personalizations[0].to[0].email", "recipient@example.com")
-- The "name" is optional.
json:update_string("personalizations[0].to[0].name", "Recipient Name")
json:update_string("from.email", "sendeexampexample@example.com")
json:update_string("subject", "Hello, World!")
json:update_string("content[0].type", "text/plain")
json:update_string("content[0].value", "Heya!")

-- Adds the "Authorization: Bearer YOUR_API_KEY" header.
http.auth_token = "YOUR_API_KEY"

local resp = chilkat.HttpResponse.new()
local success = http:http_json("POST", "https://api.sendgrid.com/v3/mail/send", json, "application/json", resp)
if not success then
    print(http.last_error_text)
    return
end

if not http.last_method_success then
    print(http.last_error_text)
else
    print("response status code: " .. resp.status_code)
    -- Display the response.
    -- If successful, the response code is 202 and the response body string is empty.
    -- (The response body string may also be empty for error response codes.)
    print(resp.body_str)
end