(Tcl) Outlook Contacts Create a Contact

See more Outlook Contact Examples

Creates an Outlook Contact.

For more information, see https://docs.microsoft.com/en-us/graph/api/user-post-contacts?view=graph-rest-1.0&tabs=http

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set http [new_CkHttp]

# Use your previously obtained access token here: Get Outlook Contacts OAuth2 Access Token (Azure AD v2.0 Endpoint).

set jsonToken [new_CkJsonObject]

set success [CkJsonObject_LoadFile $jsonToken "qa_data/tokens/outlookContacts.json"]
if {$success == 0} then {
    puts [CkJsonObject_lastErrorText $jsonToken]
    delete_CkHttp $http
    delete_CkJsonObject $jsonToken
    exit
}

CkHttp_put_AuthToken $http [CkJsonObject_stringOf $jsonToken "access_token"]

# Send the following POST:

# POST https://graph.microsoft.com/v1.0/me/contacts
# Content-type: application/json
# 
# {
#   "givenName": "Pavel",
#   "surname": "Bansky",
#   "emailAddresses": [
#     {
#       "address": "pavelb@fabrikam.onmicrosoft.com",
#       "name": "Pavel Bansky"
#     }
#   ],
#   "businessPhones": [
#     "+1 732 555 0102"
#   ]
# }

# Build the JSON body of the POST.

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

set json [new_CkJsonObject]

CkJsonObject_UpdateString $json "givenName" "Pavel"
CkJsonObject_UpdateString $json "surname" "Bansky"
CkJsonObject_UpdateString $json "emailAddresses[0].address" "pavelb@fabrikam.onmicrosoft.com"
CkJsonObject_UpdateString $json "emailAddresses[0].name" "Pavel Bansky"
CkJsonObject_UpdateString $json "businessPhones[0]" "+1 732 555 0102"

# Send the HTTP POST
# resp is a CkHttpResponse
set resp [CkHttp_PostJson2 $http "https://graph.microsoft.com/v1.0/me/contacts" "application/json" [CkJsonObject_emit $json]]
if {[CkHttp_get_LastMethodSuccess $http] != 1} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkJsonObject $jsonToken
    delete_CkJsonObject $json
    exit
}

puts "Response status code = [CkHttpResponse_get_StatusCode $resp]"
delete_CkHttpResponse $resp

set jResp [new_CkJsonObject]

CkJsonObject_Load $jResp [CkHttpResponse_bodyStr $resp]
CkJsonObject_put_EmitCompact $jResp 0
puts [CkJsonObject_emit $jResp]

# The send succeeded if the response status code = 201.
if {[CkHttpResponse_get_StatusCode $resp] != 201} then {
    puts "Failed"
    delete_CkHttp $http
    delete_CkJsonObject $jsonToken
    delete_CkJsonObject $json
    delete_CkJsonObject $jResp
    exit
}

# Sample JSON response:

# {
#   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('4ee732c3-322e-4a6b-b729-2fd1eb5c6004')/contacts/$entity",
#   "@odata.etag": "W/\"EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYfT\"",
#   "id": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=",
#   "createdDateTime": "2021-06-29T16:32:05Z",
#   "lastModifiedDateTime": "2021-06-29T16:32:06Z",
#   "changeKey": "EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYfT",
#   "categories": [
#   ],
#   "parentFolderId": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQAuAAAAAAAu7cUXL5YOTrdsUIw7-v8FAQBUcG0qWqkmQYqWLHQataQxAAAAAAEOAAA=",
#   "birthday": null,
#   "fileAs": "",
#   "displayName": "Pavel Bansky",
#   "givenName": "Pavel",
#   "initials": null,
#   "middleName": null,
#   "nickName": null,
#   "surname": "Bansky",
#   "title": null,
#   "yomiGivenName": null,
#   "yomiSurname": null,
#   "yomiCompanyName": null,
#   "generation": null,
#   "imAddresses": [
#   ],
#   "jobTitle": null,
#   "companyName": null,
#   "department": null,
#   "officeLocation": null,
#   "profession": null,
#   "businessHomePage": null,
#   "assistantName": null,
#   "manager": null,
#   "homePhones": [
#   ],
#   "mobilePhone": null,
#   "businessPhones": [
#     "+1 732 555 0102"
#   ],
#   "spouseName": null,
#   "personalNotes": "",
#   "children": [
#   ],
#   "emailAddresses": [
#     {
#       "name": "Pavel Bansky",
#       "address": "pavelb@fabrikam.onmicrosoft.com"
#     }
#   ],
#   "homeAddress": {},
#   "businessAddress": {},
#   "otherAddress": {}
# }

puts "Contact created."

delete_CkHttp $http
delete_CkJsonObject $jsonToken
delete_CkJsonObject $json
delete_CkJsonObject $jResp