Visual FoxPro

SendGrid Hello World -- Send Simple Email to Single Recipient

See more SendGrid Examples

Sends an email to a single recipient using SendGrid. Visual FoxPro

LOCAL lnSuccess
LOCAL loHttp
LOCAL loJson
LOCAL loResp

lnSuccess = 0

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

loHttp = CreateObject('Chilkat.Http')

*  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!"
*      }
*    ]
*  }

loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("personalizations[0].to[0].email","recipient@example.com")
*  The "name" is optional.
loJson.UpdateString("personalizations[0].to[0].name","Recipient Name")
loJson.UpdateString("from.email","sendeexampexample@example.com")
loJson.UpdateString("subject","Hello, World!")
loJson.UpdateString("content[0].type","text/plain")
loJson.UpdateString("content[0].value","Heya!")

*  Adds the "Authorization: Bearer YOUR_API_KEY" header.
loHttp.AuthToken = "YOUR_API_KEY"

loResp = CreateObject('Chilkat.HttpResponse')
lnSuccess = loHttp.HttpJson("POST","https://api.sendgrid.com/v3/mail/send",loJson,"application/json",loResp)
IF (lnSuccess = 0) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loJson
    RELEASE loResp
    CANCEL
ENDIF

IF (loHttp.LastMethodSuccess <> 1) THEN
    ? loHttp.LastErrorText
ELSE
    ? "response status code: " + STR(loResp.StatusCode)
    *  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.)
    ? loResp.BodyStr
ENDIF

RELEASE loHttp
RELEASE loJson
RELEASE loResp