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"];