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

See more SendGrid Examples

Note: This example requires Chilkat v11.0.0 or greater.

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
    Boolean iSuccess
    Handle hoHttp
    Variant vJson
    Handle hoJson
    Variant vResp
    Handle hoResp
    String sTemp1
    Integer iTemp1
    Boolean bTemp1

    Move False To iSuccess

    // 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"

    Get Create (RefClass(cComChilkatHttpResponse)) To hoResp
    If (Not(IsComObjectCreated(hoResp))) Begin
        Send CreateComObject of hoResp
    End
    Get pvComObject of hoJson to vJson
    Get pvComObject of hoResp to vResp
    Get ComHttpJson Of hoHttp "POST" "https://api.sendgrid.com/v3/mail/send" vJson "application/json" vResp To iSuccess
    If (iSuccess = 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
    End



End_Procedure