Objective-C

Constant Contact: Create a Contact

See more Constant Contact Examples

Creates a single contact. Objective-C

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <NSString.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 -X POST \
//   https://api.cc.email/v3/contacts \
//   -H 'accept: application/json' \
//   -H 'authorization: Bearer {access_token}' \
//   -H 'cache-control: no-cache' \
//   -H 'content-type: application/json' \
//   -d '{
//   "email_address": {
//     "address": "danipper@example.com",
//     "permission_to_send": "implicit"
//   },
//   "first_name": "David",
//   "last_name": "Nipper",
//   "job_title": "Musician",
//   "company_name": "Acme Corp.",
//   "create_source": "Account",
//   "birthday_month": 11,
//   "birthday_day": 24,
//   "anniversary": "2006-11-15",
//   "steet_addresses":{
//     "kind":"home",
//     "street": "123 Kashmir Valley Road",
//     "city": "Chicago",
//     "state": "Illinois",
//     "country": "United States",
//   }
// }'

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

// {
//   "email_address": {
//     "address": "danipper@example.com",
//     "permission_to_send": "implicit"
//   },
//   "first_name": "David",
//   "last_name": "Nipper",
//   "job_title": "Musician",
//   "company_name": "Acme Corp.",
//   "create_source": "Account",
//   "birthday_month": 11,
//   "birthday_day": 24,
//   "anniversary": "2006-11-15",
//   "steet_addresses": {
//     "kind": "home",
//     "street": "123 Kashmir Valley Road",
//     "city": "Chicago",
//     "state": "Illinois",
//     "country": "United States"
//   }
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"email_address.address" value: @"danipper@example.com"];
[json UpdateString: @"email_address.permission_to_send" value: @"implicit"];
[json UpdateString: @"first_name" value: @"David"];
[json UpdateString: @"last_name" value: @"Nipper"];
[json UpdateString: @"job_title" value: @"Musician"];
[json UpdateString: @"company_name" value: @"Acme Corp."];
[json UpdateString: @"create_source" value: @"Account"];
[json UpdateInt: @"birthday_month" value: [NSNumber numberWithInt: 11]];
[json UpdateInt: @"birthday_day" value: [NSNumber numberWithInt: 24]];
[json UpdateString: @"anniversary" value: @"2006-11-15"];
[json UpdateString: @"steet_addresses.kind" value: @"home"];
[json UpdateString: @"steet_addresses.street" value: @"123 Kashmir Valley Road"];
[json UpdateString: @"steet_addresses.city" value: @"Chicago"];
[json UpdateString: @"steet_addresses.state" value: @"Illinois"];
[json UpdateString: @"steet_addresses.country" value: @"United States"];

[http SetRequestHeader: @"content-type" value: @"application/json"];
// Adds the "Authorization: Bearer ACCESS_TOKEN" header.
http.AuthToken = @"ACCESS_TOKEN";
[http SetRequestHeader: @"cache-control" value: @"no-cache"];
[http SetRequestHeader: @"accept" value: @"application/json"];

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

CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
[resp GetBodySb: sbResponseBody];
CkoJsonObject *jResp = [[CkoJsonObject alloc] init];
[jResp LoadSb: sbResponseBody];
jResp.EmitCompact = NO;

NSLog(@"%@",@"Response Body:");
NSLog(@"%@",[jResp Emit]);

int respStatusCode = [resp.StatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",resp.Header);
    NSLog(@"%@",@"Failed.");
    return;
}

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "contact_id": "{contact_id}",
//   "email_address": {
//     "address": "danipper@example.com",
//     "permission_to_send": "implicit",
//     "created_at": "2018-02-23T13:38:28-05:00",
//     "updated_at": "2018-02-23T13:38:28-05:00",
//     "opt_in_source": "Account",
//     "opt_in_date": "2018-02-23T13:38:28-05:00",
//     "confirm_status": "off"
//   },
//   "first_name": "David",
//   "last_name": "Nipper",
//   "job_title": "Musician",
//   "company_name": "Acme Corp.",
//   "birthday_month": 11,
//   "birthday_day": 24,
//   "anniversary": "2006-11-15",
//   "create_source": "Account",
//   "created_at": "2018-02-23T13:38:28-05:00",
//   "updated_at": "2018-02-23T13:38:28-05:00"
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

NSString *contact_id = [jResp StringOf: @"contact_id"];
NSString *email_addressAddress = [jResp StringOf: @"email_address.address"];
NSString *email_addressPermission_to_send = [jResp StringOf: @"email_address.permission_to_send"];
NSString *email_addressCreated_at = [jResp StringOf: @"email_address.created_at"];
NSString *email_addressUpdated_at = [jResp StringOf: @"email_address.updated_at"];
NSString *email_addressOpt_in_source = [jResp StringOf: @"email_address.opt_in_source"];
NSString *email_addressOpt_in_date = [jResp StringOf: @"email_address.opt_in_date"];
NSString *email_addressConfirm_status = [jResp StringOf: @"email_address.confirm_status"];
NSString *first_name = [jResp StringOf: @"first_name"];
NSString *last_name = [jResp StringOf: @"last_name"];
NSString *job_title = [jResp StringOf: @"job_title"];
NSString *company_name = [jResp StringOf: @"company_name"];
int birthday_month = [[jResp IntOf: @"birthday_month"] intValue];
int birthday_day = [[jResp IntOf: @"birthday_day"] intValue];
NSString *anniversary = [jResp StringOf: @"anniversary"];
NSString *create_source = [jResp StringOf: @"create_source"];
NSString *created_at = [jResp StringOf: @"created_at"];
NSString *updated_at = [jResp StringOf: @"updated_at"];