Sample code for 30+ languages & platforms
Objective-C

SugarCRM Create a Record

See more SugarCRM Examples

Submit a record to the Sugar instance using the / endpoint. In this example we are going to create an Account record with a Name of 'Test Record' and an email of 'test@sugar.com'.

Chilkat Objective-C Downloads

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 -H OAuth-Token:<access_token> -H Cache-Control:no-cache -d '{ 
//    "name":"Test Record",
//    "email1":"test@sugar.com"
// }' http://<site_url>/rest/v10/Accounts

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "name": "Test Record",
//   "email1": "test@sugar.com"
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"name" value: @"Test Record"];
[json UpdateString: @"email1" value: @"test@sugar.com"];

[http SetRequestHeader: @"Cache-Control" value: @"no-cache"];
[http SetRequestHeader: @"OAuth-Token" value: @"<access_token>"];

CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"http://<site_url>/rest/v10/Accounts" 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)

// {
//   "id": "ab2222df-73da-0e92-6887-5705428f4d68",
//   "name": "Test Record",
//   "date_entered": "2016-04-06T13:07:41-04:00",
//   "date_modified": "2016-04-06T13:07:41-04:00",
//   "modified_user_id": "1",
//   "modified_by_name": "Administrator",
//   "modified_user_link": {
//     "full_name": "Administrator",
//     "id": "1",
//     "_acl": {
//       "fields": [
//       ],
//       "delete": "no",
//       "_hash": "8e11bf9be8f04daddee9d08d44ea891e"
//     }
//   },
//   "created_by": "1",
//   "created_by_name": "Administrator",
//   "created_by_link": {
//     "full_name": "Administrator",
//     "id": "1",
//     "_acl": {
//       "fields": [
//       ],
//       "delete": "no",
//       "_hash": "8e11bf9be8f04daddee9d08d44ea891e"
//     }
//   },
//   "description": "",
//   "deleted": false,
//   "facebook": "",
//   "twitter": "",
//   "googleplus": "",
//   "account_type": "",
//   "industry": "",
//   "annual_revenue": "",
//   "phone_fax": "",
//   "billing_address_street": "",
//   "billing_address_street_2": "",
//   "billing_address_street_3": "",
//   "billing_address_street_4": "",
//   "billing_address_city": "",
//   "billing_address_state": "",
//   "billing_address_postalcode": "",
//   "billing_address_country": "",
//   "rating": "",
//   "phone_office": "",
//   "phone_alternate": "",
//   "website": "",
//   "ownership": "",
//   "employees": "",
//   "ticker_symbol": "",
//   "shipping_address_street": "",
//   "shipping_address_street_2": "",
//   "shipping_address_street_3": "",
//   "shipping_address_street_4": "",
//   "shipping_address_city": "",
//   "shipping_address_state": "",
//   "shipping_address_postalcode": "",
//   "shipping_address_country": "",
//   "parent_id": "",
//   "sic_code": "",
//   "duns_num": "",
//   "parent_name": "",
//   "member_of": {
//     "name": "",
//     "id": "",
//     "_acl": {
//       "fields": [
//       ],
//       "_hash": "654d337e0e912edaa00dbb0fb3dc3c17"
//     }
//   },
//   "campaign_id": "",
//   "campaign_name": "",
//   "campaign_accounts": {
//     "name": "",
//     "id": "",
//     "_acl": {
//       "fields": [
//       ],
//       "_hash": "654d337e0e912edaa00dbb0fb3dc3c17"
//     }
//   },
//   "following": true,
//   "my_favorite": false,
//   "tag": [
//   ],
//   "assigned_user_id": "",
//   "assigned_user_name": "",
//   "assigned_user_link": {
//     "full_name": "",
//     "id": "",
//     "_acl": {
//       "fields": [
//       ],
//       "_hash": "654d337e0e912edaa00dbb0fb3dc3c17"
//     }
//   },
//   "team_count": "",
//   "team_count_link": {
//     "team_count": "",
//     "id": "1",
//     "_acl": {
//       "fields": [
//       ],
//       "_hash": "654d337e0e912edaa00dbb0fb3dc3c17"
//     }
//   },
//   "team_name": [
//     {
//       "id": 1,
//       "name": "Global",
//       "name_2": "",
//       "primary": true
//     }
//   ],
//   "email": [
//     {
//       "email_address": "test@sugar.com",
//       "invalid_email": false,
//       "opt_out": false,
//       "primary_address": true,
//       "reply_to_address": false
//     }
//   ],
//   "email1": "test@sugar.com",
//   "email2": "",
//   "invalid_email": false,
//   "email_opt_out": false,
//   "email_addresses_non_primary": "",
//   "_acl": {
//     "fields": {}
//   },
//   "_module": "Accounts"
// }

// 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 *id = 0;
NSString *name = 0;
NSString *date_entered = 0;
NSString *date_modified = 0;
NSString *modified_user_id = 0;
NSString *modified_by_name = 0;
NSString *modified_user_linkFull_name = 0;
NSString *modified_user_linkId = 0;
NSString *modified_user_link_aclDelete = 0;
NSString *modified_user_link_acl_hash = 0;
NSString *created_by = 0;
NSString *created_by_name = 0;
NSString *created_by_linkFull_name = 0;
NSString *created_by_linkId = 0;
NSString *created_by_link_aclDelete = 0;
NSString *created_by_link_acl_hash = 0;
NSString *description = 0;
BOOL deleted;
NSString *facebook = 0;
NSString *twitter = 0;
NSString *googleplus = 0;
NSString *account_type = 0;
NSString *industry = 0;
NSString *annual_revenue = 0;
NSString *phone_fax = 0;
NSString *billing_address_street = 0;
NSString *billing_address_street_2 = 0;
NSString *billing_address_street_3 = 0;
NSString *billing_address_street_4 = 0;
NSString *billing_address_city = 0;
NSString *billing_address_state = 0;
NSString *billing_address_postalcode = 0;
NSString *billing_address_country = 0;
NSString *rating = 0;
NSString *phone_office = 0;
NSString *phone_alternate = 0;
NSString *website = 0;
NSString *ownership = 0;
NSString *employees = 0;
NSString *ticker_symbol = 0;
NSString *shipping_address_street = 0;
NSString *shipping_address_street_2 = 0;
NSString *shipping_address_street_3 = 0;
NSString *shipping_address_street_4 = 0;
NSString *shipping_address_city = 0;
NSString *shipping_address_state = 0;
NSString *shipping_address_postalcode = 0;
NSString *shipping_address_country = 0;
NSString *parent_id = 0;
NSString *sic_code = 0;
NSString *duns_num = 0;
NSString *parent_name = 0;
NSString *member_ofName = 0;
NSString *member_ofId = 0;
NSString *member_of_acl_hash = 0;
NSString *campaign_id = 0;
NSString *campaign_name = 0;
NSString *campaign_accountsName = 0;
NSString *campaign_accountsId = 0;
NSString *campaign_accounts_acl_hash = 0;
BOOL following;
BOOL my_favorite;
NSString *assigned_user_id = 0;
NSString *assigned_user_name = 0;
NSString *assigned_user_linkFull_name = 0;
NSString *assigned_user_linkId = 0;
NSString *assigned_user_link_acl_hash = 0;
NSString *team_count = 0;
NSString *team_count_linkTeam_count = 0;
NSString *team_count_linkId = 0;
NSString *team_count_link_acl_hash = 0;
NSString *email1 = 0;
NSString *email2 = 0;
BOOL invalid_email;
BOOL email_opt_out;
NSString *email_addresses_non_primary = 0;
NSString *v_module = 0;
int i;
int count_i;
int id_int;
NSString *name_2 = 0;
BOOL primary;
NSString *email_address = 0;
BOOL opt_out;
BOOL primary_address;
BOOL reply_to_address;

id = [jResp StringOf: @"id"];
name = [jResp StringOf: @"name"];
date_entered = [jResp StringOf: @"date_entered"];
date_modified = [jResp StringOf: @"date_modified"];
modified_user_id = [jResp StringOf: @"modified_user_id"];
modified_by_name = [jResp StringOf: @"modified_by_name"];
modified_user_linkFull_name = [jResp StringOf: @"modified_user_link.full_name"];
modified_user_linkId = [jResp StringOf: @"modified_user_link.id"];
modified_user_link_aclDelete = [jResp StringOf: @"modified_user_link._acl.delete"];
modified_user_link_acl_hash = [jResp StringOf: @"modified_user_link._acl._hash"];
created_by = [jResp StringOf: @"created_by"];
created_by_name = [jResp StringOf: @"created_by_name"];
created_by_linkFull_name = [jResp StringOf: @"created_by_link.full_name"];
created_by_linkId = [jResp StringOf: @"created_by_link.id"];
created_by_link_aclDelete = [jResp StringOf: @"created_by_link._acl.delete"];
created_by_link_acl_hash = [jResp StringOf: @"created_by_link._acl._hash"];
description = [jResp StringOf: @"description"];
deleted = [jResp BoolOf: @"deleted"];
facebook = [jResp StringOf: @"facebook"];
twitter = [jResp StringOf: @"twitter"];
googleplus = [jResp StringOf: @"googleplus"];
account_type = [jResp StringOf: @"account_type"];
industry = [jResp StringOf: @"industry"];
annual_revenue = [jResp StringOf: @"annual_revenue"];
phone_fax = [jResp StringOf: @"phone_fax"];
billing_address_street = [jResp StringOf: @"billing_address_street"];
billing_address_street_2 = [jResp StringOf: @"billing_address_street_2"];
billing_address_street_3 = [jResp StringOf: @"billing_address_street_3"];
billing_address_street_4 = [jResp StringOf: @"billing_address_street_4"];
billing_address_city = [jResp StringOf: @"billing_address_city"];
billing_address_state = [jResp StringOf: @"billing_address_state"];
billing_address_postalcode = [jResp StringOf: @"billing_address_postalcode"];
billing_address_country = [jResp StringOf: @"billing_address_country"];
rating = [jResp StringOf: @"rating"];
phone_office = [jResp StringOf: @"phone_office"];
phone_alternate = [jResp StringOf: @"phone_alternate"];
website = [jResp StringOf: @"website"];
ownership = [jResp StringOf: @"ownership"];
employees = [jResp StringOf: @"employees"];
ticker_symbol = [jResp StringOf: @"ticker_symbol"];
shipping_address_street = [jResp StringOf: @"shipping_address_street"];
shipping_address_street_2 = [jResp StringOf: @"shipping_address_street_2"];
shipping_address_street_3 = [jResp StringOf: @"shipping_address_street_3"];
shipping_address_street_4 = [jResp StringOf: @"shipping_address_street_4"];
shipping_address_city = [jResp StringOf: @"shipping_address_city"];
shipping_address_state = [jResp StringOf: @"shipping_address_state"];
shipping_address_postalcode = [jResp StringOf: @"shipping_address_postalcode"];
shipping_address_country = [jResp StringOf: @"shipping_address_country"];
parent_id = [jResp StringOf: @"parent_id"];
sic_code = [jResp StringOf: @"sic_code"];
duns_num = [jResp StringOf: @"duns_num"];
parent_name = [jResp StringOf: @"parent_name"];
member_ofName = [jResp StringOf: @"member_of.name"];
member_ofId = [jResp StringOf: @"member_of.id"];
member_of_acl_hash = [jResp StringOf: @"member_of._acl._hash"];
campaign_id = [jResp StringOf: @"campaign_id"];
campaign_name = [jResp StringOf: @"campaign_name"];
campaign_accountsName = [jResp StringOf: @"campaign_accounts.name"];
campaign_accountsId = [jResp StringOf: @"campaign_accounts.id"];
campaign_accounts_acl_hash = [jResp StringOf: @"campaign_accounts._acl._hash"];
following = [jResp BoolOf: @"following"];
my_favorite = [jResp BoolOf: @"my_favorite"];
assigned_user_id = [jResp StringOf: @"assigned_user_id"];
assigned_user_name = [jResp StringOf: @"assigned_user_name"];
assigned_user_linkFull_name = [jResp StringOf: @"assigned_user_link.full_name"];
assigned_user_linkId = [jResp StringOf: @"assigned_user_link.id"];
assigned_user_link_acl_hash = [jResp StringOf: @"assigned_user_link._acl._hash"];
team_count = [jResp StringOf: @"team_count"];
team_count_linkTeam_count = [jResp StringOf: @"team_count_link.team_count"];
team_count_linkId = [jResp StringOf: @"team_count_link.id"];
team_count_link_acl_hash = [jResp StringOf: @"team_count_link._acl._hash"];
email1 = [jResp StringOf: @"email1"];
email2 = [jResp StringOf: @"email2"];
invalid_email = [jResp BoolOf: @"invalid_email"];
email_opt_out = [jResp BoolOf: @"email_opt_out"];
email_addresses_non_primary = [jResp StringOf: @"email_addresses_non_primary"];
v_module = [jResp StringOf: @"_module"];
i = 0;
count_i = [[jResp SizeOfArray: @"modified_user_link._acl.fields"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"created_by_link._acl.fields"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"member_of._acl.fields"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"campaign_accounts._acl.fields"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"tag"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"assigned_user_link._acl.fields"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"team_count_link._acl.fields"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"team_name"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    id_int = [[jResp IntOf: @"team_name[i].id"] intValue];
    name = [jResp StringOf: @"team_name[i].name"];
    name_2 = [jResp StringOf: @"team_name[i].name_2"];
    primary = [jResp BoolOf: @"team_name[i].primary"];
    i = i + 1;
}

i = 0;
count_i = [[jResp SizeOfArray: @"email"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    email_address = [jResp StringOf: @"email[i].email_address"];
    invalid_email = [jResp BoolOf: @"email[i].invalid_email"];
    opt_out = [jResp BoolOf: @"email[i].opt_out"];
    primary_address = [jResp BoolOf: @"email[i].primary_address"];
    reply_to_address = [jResp BoolOf: @"email[i].reply_to_address"];
    i = i + 1;
}