(Tcl) GetHarvest - Create Contact

Creates a new contact object. Returns a contact object and a 201 Created response code if the call succeeded.

For more information, see https://help.getharvest.com/api-v2/clients-api/clients/contacts/

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set http [new_CkHttp]

# Implements the following CURL command:

# curl "https://api.harvestapp.com/v2/contacts" \
#   -H "Authorization: Bearer ACCESS_TOKEN" \
#   -H "Harvest-Account-Id: ACCOUNT_ID" \
#   -H "User-Agent: MyApp (yourname@example.com)" \
#   -X POST \
#   -H "Content-Type: application/json" \
#   -d '{"client_id":8282839,"first_name":"George","last_name":"Frank","email":"georgefrank@example.com"}'

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

# The following JSON is sent in the request body.

# {
#   "client_id": 8282839,
#   "first_name": "George",
#   "last_name": "Frank",
#   "email": "georgefrank@example.com"
# }

set json [new_CkJsonObject]

CkJsonObject_UpdateInt $json "client_id" 8282839
CkJsonObject_UpdateString $json "first_name" "George"
CkJsonObject_UpdateString $json "last_name" "Frank"
CkJsonObject_UpdateString $json "email" "georgefrank@example.com"

CkHttp_SetRequestHeader $http "User-Agent" "MyApp (yourname@example.com)"
CkHttp_SetRequestHeader $http "Content-Type" "application/json"
CkHttp_SetRequestHeader $http "Authorization" "Bearer ACCESS_TOKEN"
CkHttp_SetRequestHeader $http "Harvest-Account-Id" "ACCOUNT_ID"

# resp is a CkHttpResponse
set resp [CkHttp_PostJson3 $http "https://api.harvestapp.com/v2/contacts" "application/json" $json]
if {[CkHttp_get_LastMethodSuccess $http] == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkJsonObject $json
    exit
}

set sbResponseBody [new_CkStringBuilder]

CkHttpResponse_GetBodySb $resp $sbResponseBody
set jResp [new_CkJsonObject]

CkJsonObject_LoadSb $jResp $sbResponseBody
CkJsonObject_put_EmitCompact $jResp 0

puts "Response Body:"
puts [CkJsonObject_emit $jResp]

set respStatusCode [CkHttpResponse_get_StatusCode $resp]
puts "Response Status Code = $respStatusCode"
if {$respStatusCode >= 400} then {
    puts "Response Header:"
    puts [CkHttpResponse_header $resp]
    puts "Failed."
    delete_CkHttpResponse $resp

    delete_CkHttp $http
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbResponseBody
    delete_CkJsonObject $jResp
    exit
}

delete_CkHttpResponse $resp

# Sample JSON response:

# {
#   "id": 4706510,
#   "title": null,
#   "first_name": "George",
#   "last_name": "Frank",
#   "email": "georgefrank@example.com",
#   "phone_office": "",
#   "phone_mobile": "",
#   "fax": "",
#   "created_at": "2017-06-26T21:44:57Z",
#   "updated_at": "2017-06-26T21:44:57Z",
#   "client": {
#     "id": 5735776,
#     "name": "123 Industries"
#   }
# }

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

set id [CkJsonObject_IntOf $jResp "id"]
set title [CkJsonObject_stringOf $jResp "title"]
set first_name [CkJsonObject_stringOf $jResp "first_name"]
set last_name [CkJsonObject_stringOf $jResp "last_name"]
set email [CkJsonObject_stringOf $jResp "email"]
set phone_office [CkJsonObject_stringOf $jResp "phone_office"]
set phone_mobile [CkJsonObject_stringOf $jResp "phone_mobile"]
set fax [CkJsonObject_stringOf $jResp "fax"]
set created_at [CkJsonObject_stringOf $jResp "created_at"]
set updated_at [CkJsonObject_stringOf $jResp "updated_at"]
set clientId [CkJsonObject_IntOf $jResp "client.id"]
set clientName [CkJsonObject_stringOf $jResp "client.name"]

delete_CkHttp $http
delete_CkJsonObject $json
delete_CkStringBuilder $sbResponseBody
delete_CkJsonObject $jResp