Objective-C

SendGrid Hello World -- Send Simple Email to Single Recipient

See more SendGrid Examples

Sends an email to a single recipient using SendGrid. Objective-C

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>

BOOL success = NO;

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

CkoHttp *http = [[CkoHttp alloc] init];

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

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"personalizations[0].to[0].email" value: @"recipient@example.com"];
//  The "name" is optional.
[json UpdateString: @"personalizations[0].to[0].name" value: @"Recipient Name"];
[json UpdateString: @"from.email" value: @"sendeexampexample@example.com"];
[json UpdateString: @"subject" value: @"Hello, World!"];
[json UpdateString: @"content[0].type" value: @"text/plain"];
[json UpdateString: @"content[0].value" value: @"Heya!"];

//  Adds the "Authorization: Bearer YOUR_API_KEY" header.
http.AuthToken = @"YOUR_API_KEY";

CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"https://api.sendgrid.com/v3/mail/send" json: json contentType: @"application/json" response: resp];
if (success == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

if (http.LastMethodSuccess != YES) {
    NSLog(@"%@",http.LastErrorText);
}
else {
    NSLog(@"%@%d",@"response status code: ",[resp.StatusCode intValue]);
    //  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.)
    NSLog(@"%@",resp.BodyStr);
}