Sample code for 30+ languages & platforms
Java Requires Chilkat v11.0.0+

Outlook Contacts Update (PATCH) a Contact

See more Outlook Contact Examples

Update the properties of an Outlook contact object.

Chilkat Java Downloads

Chilkat2 Java
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;
import com.chilkatsoft.chilkat2.HttpResponse;
import com.chilkatsoft.chilkat2.JsonObject;

public class ChilkatExample {

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

        Http http = new Http();

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

        JsonObject jsonToken = new JsonObject();
        try {
            jsonToken.loadFile("qa_data/tokens/outlookContacts.json");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        http.setAuthToken(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

        JsonObject json = new JsonObject();
        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).

        String id = "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=";
        http.setUrlVar("id", id);

        // Send the HTTP PATCH
        HttpResponse resp = new HttpResponse();
        try {
            http.httpJson("PATCH", "https://graph.microsoft.com/v1.0/me/contacts/{$id}", json, "application/json", resp);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        System.out.println("Response status code = " + resp.getStatusCode());

        JsonObject jResp = new JsonObject();
        jResp.load(resp.getBodyStr());
        jResp.setEmitCompact(false);
        System.out.println(jResp.emit());

        // The send succeeded if the response status code = 201.
        if (resp.getStatusCode() != 200) {
            System.out.println("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": {}
        // }

        System.out.println("Contact updated.");
    }
}