(Visual FoxPro) SendGrid Hello World -- Send Simple Email to Single Recipient

See more SendGrid Examples

Sends an email to a single recipient using SendGrid.

For more information, see https://sendgrid.com/docs/for-developers/sending-email/curl-examples/

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loHttp
LOCAL lnSuccess
LOCAL loJson
LOCAL loResp

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
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!"
*     }
*   ]
* }

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
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"
loHttp.SetRequestHeader("Content-Type","application/json")

loResp = loHttp.PostJson3("https://api.sendgrid.com/v3/mail/send","application/json",loJson)
IF (loHttp.LastMethodSuccess = 0) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loJson
    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
    RELEASE loResp
ENDIF

RELEASE loHttp
RELEASE loJson