Java

SendGrid Hello World -- Send Simple Email to Single Recipient

See more SendGrid Examples

Sends an email to a single recipient using SendGrid. Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;
import com.chilkatsoft.chilkat2.HttpResponse;
import com.chilkatsoft.chilkat2.JsonObject;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example assumes the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        Http http = new 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!"
        //     }
        //   ]
        // }

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

        // Adds the "Authorization: Bearer YOUR_API_KEY" header.
        http.setAuthToken("YOUR_API_KEY");

        HttpResponse resp = new HttpResponse();
        try {
            http.httpJson("POST", "https://api.sendgrid.com/v3/mail/send", json, "application/json", resp);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        if (!http.getLastMethodSuccess()) {
            System.out.println(http.getLastErrorText());
        } else {
            System.out.println("response status code: " + resp.getStatusCode());
            // 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.)
            System.out.println(resp.getBodyStr());
        }
    }
}