(DataFlex) 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

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoHttp
    Boolean iSuccess
    Variant vJson
    Handle hoJson
    Variant vResp
    Handle hoResp
    String sTemp1
    Integer iTemp1
    Boolean bTemp1

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

    Get Create (RefClass(cComChilkatHttp)) To hoHttp
    If (Not(IsComObjectCreated(hoHttp))) Begin
        Send CreateComObject of hoHttp
    End

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

    Get Create (RefClass(cComChilkatJsonObject)) To hoJson
    If (Not(IsComObjectCreated(hoJson))) Begin
        Send CreateComObject of hoJson
    End
    Get ComUpdateString Of hoJson "personalizations[0].to[0].email" "recipient@example.com" To iSuccess
    // The "name" is optional.
    Get ComUpdateString Of hoJson "personalizations[0].to[0].name" "Recipient Name" To iSuccess
    Get ComUpdateString Of hoJson "from.email" "sendeexampexample@example.com" To iSuccess
    Get ComUpdateString Of hoJson "subject" "Hello, World!" To iSuccess
    Get ComUpdateString Of hoJson "content[0].type" "text/plain" To iSuccess
    Get ComUpdateString Of hoJson "content[0].value" "Heya!" To iSuccess

    // Adds the "Authorization: Bearer YOUR_API_KEY" header.
    Set ComAuthToken Of hoHttp To "YOUR_API_KEY"
    Send ComSetRequestHeader To hoHttp "Content-Type" "application/json"

    Get pvComObject of hoJson to vJson
    Get ComPostJson3 Of hoHttp "https://api.sendgrid.com/v3/mail/send" "application/json" vJson To vResp
    If (IsComObject(vResp)) Begin
        Get Create (RefClass(cComChilkatHttpResponse)) To hoResp
        Set pvComObject Of hoResp To vResp
    End
    Get ComLastMethodSuccess Of hoHttp To bTemp1
    If (bTemp1 = False) Begin
        Get ComLastErrorText Of hoHttp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get ComLastMethodSuccess Of hoHttp To bTemp1
    If (bTemp1 <> True) Begin
        Get ComLastErrorText Of hoHttp To sTemp1
        Showln sTemp1
    End
    Else Begin
        Get ComStatusCode Of hoResp To iTemp1
        Showln "response status code: " iTemp1
        // 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.)
        Get ComBodyStr Of hoResp To sTemp1
        Showln sTemp1
        Send Destroy of hoResp
    End



End_Procedure