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);
}