Pascal (Lazarus/Delphi)

SendGrid Hello World -- Send Simple Email to Single Recipient

See more SendGrid Examples

Sends an email to a single recipient using SendGrid. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Http,
  Chilkat.HttpResponse,
  Chilkat.JsonObject;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  http: THttp;
  json: TJsonObject;
  resp: THttpResponse;

begin
  success := False;

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

  http := THttp.Create;

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

  json := TJsonObject.Create;
  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.AuthToken := 'YOUR_API_KEY';

  resp := THttpResponse.Create;
  success := http.HttpJson('POST','https://api.sendgrid.com/v3/mail/send',json,'application/json',resp);
  if (success = False) then
    begin
      WriteLn(http.LastErrorText);
      Exit;
    end;

  if (http.LastMethodSuccess <> True) then
    begin
      WriteLn(http.LastErrorText);
    end
  else
    begin
      WriteLn('response status code: ' + resp.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.)
      WriteLn(resp.BodyStr);
    end;


  http.Free;
  json.Free;
  resp.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.