(VBScript) Outlook Contacts Update (PATCH) a Contact

See more Outlook Contact Examples

Update the properties of an Outlook contact object.

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

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Dim fso, outFile
Set fso = CreateObject("Scripting.FileSystemObject")
'Create a Unicode (utf-16) output text file.
Set outFile = fso.CreateTextFile("output.txt", True, True)

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

' For versions of Chilkat < 10.0.0, use CreateObject("Chilkat_9_5_0.Http")
set http = CreateObject("Chilkat.Http")

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

' For versions of Chilkat < 10.0.0, use CreateObject("Chilkat_9_5_0.JsonObject")
set jsonToken = CreateObject("Chilkat.JsonObject")
success = jsonToken.LoadFile("qa_data/tokens/outlookContacts.json")
If (success = 0) Then
    outFile.WriteLine(jsonToken.LastErrorText)
    WScript.Quit
End If

http.AuthToken = jsonToken.StringOf("access_token")

' Send the following PATCH:

' PATCH https://graph.microsoft.com/v1.0/me/contacts/{id}
' Content-type: application/json
' Content-length: 1977
' 
' {
'   "homeAddress": {
'     "street": "123 Some street",
'     "city": "Seattle",
'     "state": "WA",
'     "postalCode": "98121"
'   },
'   "birthday": "1974-07-22"
' }

' Build the JSON body of the POST.

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

' For versions of Chilkat < 10.0.0, use CreateObject("Chilkat_9_5_0.JsonObject")
set json = CreateObject("Chilkat.JsonObject")
success = json.UpdateString("homeAddress.street","123 Some street")
success = json.UpdateString("homeAddress.city","Seattle")
success = json.UpdateString("homeAddress.state","WA")
success = json.UpdateString("homeAddress.postalCode","98121")
success = json.UpdateString("birthday","1974-07-22")

' We need the ID of the contact to be updated.
' This was available in the response when we created the contact:  Create an Outlook Contact.
' Or you can list contacts to get the ID: List Outlook Contacts).

id = "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA="
success = http.SetUrlVar("id",id)

' Send the HTTP PATCH
' resp is a Chilkat.HttpResponse
Set resp = http.PText("PATCH","https://graph.microsoft.com/v1.0/me/contacts/{$id}",json.Emit(),"utf-8","application/json",0,0)
If (http.LastMethodSuccess <> 1) Then
    outFile.WriteLine(http.LastErrorText)
    WScript.Quit
End If

outFile.WriteLine("Response status code = " & resp.StatusCode)

' For versions of Chilkat < 10.0.0, use CreateObject("Chilkat_9_5_0.JsonObject")
set jResp = CreateObject("Chilkat.JsonObject")
success = jResp.Load(resp.BodyStr)
jResp.EmitCompact = 0
outFile.WriteLine(jResp.Emit())

' The send succeeded if the response status code = 201.
If (resp.StatusCode <> 200) Then
    outFile.WriteLine("Failed")
    WScript.Quit
End If

' Sample JSON response:

' {
'   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('4ee732c3-322e-4a6b-b729-2fd1eb5c6004')/contacts/$entity",
'   "@odata.etag": "W/\"EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYu5\"",
'   "id": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=",
'   "createdDateTime": "2021-06-29T16:32:05Z",
'   "lastModifiedDateTime": "2021-06-29T16:57:39Z",
'   "changeKey": "EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYu5",
'   "categories": [
'   ],
'   "parentFolderId": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQAuAAAAAAAu7cUXL5YOTrdsUIw7-v8FAQBUcG0qWqkmQYqWLHQataQxAAAAAAEOAAA=",
'   "birthday": "1974-07-22T11:59:00Z",
'   "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": {
'     "street": "123 Some street",
'     "city": "Seattle",
'     "state": "WA",
'     "postalCode": "98121"
'   },
'   "businessAddress": {},
'   "otherAddress": {}
' }

outFile.WriteLine("Contact updated.")

outFile.Close