Dart Requires Chilkat v11.0.0+

Outlook Contacts Update (PATCH) a Contact

See more Outlook Contact Examples

Update the properties of an Outlook contact object. Dart

import 'package:chilkat/chilkat.dart';

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

  final http = CkHttp();

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

  final jsonToken = CkJsonObject();
  try {
    jsonToken.loadFile('qa_data/tokens/outlookContacts.json');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  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

  final json = CkJsonObject();
  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).

  final id = 'AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=';
  http.setUrlVar('id', id);

  // Send the HTTP PATCH
  final resp = CkHttpResponse();
  try {
    http.httpJson('PATCH', 'https://graph.microsoft.com/v1.0/me/contacts/{\$id}', json, 'application/json', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('Response status code = ${resp.statusCode}');

  final jResp = CkJsonObject();
  jResp.load(resp.bodyStr);
  jResp.emitCompact = false;
  print(jResp.emit());

  // The send succeeded if the response status code = 201.
  if (resp.statusCode != 200) {
    print('Failed');
    return;
  }

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

  print('Contact updated.');
}