Delphi ActiveX Requires Chilkat v11.0.0+

Outlook Contacts Update (PATCH) a Contact

See more Outlook Contact Examples

Update the properties of an Outlook contact object. Delphi ActiveX

var
success: Integer;
http: TChilkatHttp;
jsonToken: TChilkatJsonObject;
json: TChilkatJsonObject;
id: WideString;
resp: TChilkatHttpResponse;
jResp: TChilkatJsonObject;

begin
success := 0;

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

http := TChilkatHttp.Create(Self);

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

jsonToken := TChilkatJsonObject.Create(Self);
success := jsonToken.LoadFile('qa_data/tokens/outlookContacts.json');
if (success = 0) then
  begin
    Memo1.Lines.Add(jsonToken.LastErrorText);
    Exit;
  end;

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

json := TChilkatJsonObject.Create(Self);
json.UpdateString('homeAddress.street','123 Some street');
json.UpdateString('homeAddress.city','Seattle');
json.UpdateString('homeAddress.state','WA');
json.UpdateString('homeAddress.postalCode','98121');
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=';
http.SetUrlVar('id',id);

//  Send the HTTP PATCH
resp := TChilkatHttpResponse.Create(Self);
success := http.HttpJson('PATCH','https://graph.microsoft.com/v1.0/me/contacts/{$id}',json.ControlInterface,'application/json',resp.ControlInterface);
if (success = 0) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

Memo1.Lines.Add('Response status code = ' + IntToStr(resp.StatusCode));

jResp := TChilkatJsonObject.Create(Self);
jResp.Load(resp.BodyStr);
jResp.EmitCompact := 0;
Memo1.Lines.Add(jResp.Emit());

//  The send succeeded if the response status code = 201.
if (resp.StatusCode <> 200) then
  begin
    Memo1.Lines.Add('Failed');
    Exit;
  end;

//  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": {}
//  }

Memo1.Lines.Add('Contact updated.');