C

Outlook Contacts Update (PATCH) a Contact

See more Outlook Contact Examples

Update the properties of an Outlook contact object. C

#include <C_CkHttp.h>
#include <C_CkJsonObject.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttp http;
    HCkJsonObject jsonToken;
    HCkJsonObject json;
    const char *id;
    HCkHttpResponse resp;
    HCkJsonObject jResp;

    success = FALSE;

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

    http = CkHttp_Create();

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

    jsonToken = CkJsonObject_Create();
    success = CkJsonObject_LoadFile(jsonToken,"qa_data/tokens/outlookContacts.json");
    if (success == FALSE) {
        printf("%s\n",CkJsonObject_lastErrorText(jsonToken));
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(jsonToken);
        return;
    }

    CkHttp_putAuthToken(http,CkJsonObject_stringOf(jsonToken,"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 = CkJsonObject_Create();
    CkJsonObject_UpdateString(json,"homeAddress.street","123 Some street");
    CkJsonObject_UpdateString(json,"homeAddress.city","Seattle");
    CkJsonObject_UpdateString(json,"homeAddress.state","WA");
    CkJsonObject_UpdateString(json,"homeAddress.postalCode","98121");
    CkJsonObject_UpdateString(json,"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=";
    CkHttp_SetUrlVar(http,"id",id);

    // Send the HTTP PATCH
    resp = CkHttpResponse_Create();
    success = CkHttp_HttpJson(http,"PATCH","https://graph.microsoft.com/v1.0/me/contacts/{$id}",json,"application/json",resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(jsonToken);
        CkJsonObject_Dispose(json);
        CkHttpResponse_Dispose(resp);
        return;
    }

    printf("Response status code = %d\n",CkHttpResponse_getStatusCode(resp));

    jResp = CkJsonObject_Create();
    CkJsonObject_Load(jResp,CkHttpResponse_bodyStr(resp));
    CkJsonObject_putEmitCompact(jResp,FALSE);
    printf("%s\n",CkJsonObject_emit(jResp));

    // The send succeeded if the response status code = 201.
    if (CkHttpResponse_getStatusCode(resp) != 200) {
        printf("Failed\n");
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(jsonToken);
        CkJsonObject_Dispose(json);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(jResp);
        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": {}
    // }

    printf("Contact updated.\n");


    CkHttp_Dispose(http);
    CkJsonObject_Dispose(jsonToken);
    CkJsonObject_Dispose(json);
    CkHttpResponse_Dispose(resp);
    CkJsonObject_Dispose(jResp);

    }