(SQL Server) 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

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    -- This example requires the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

    DECLARE @http int
    -- Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

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

    DECLARE @jsonToken int
    -- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jsonToken OUT

    DECLARE @success int
    EXEC sp_OAMethod @jsonToken, 'LoadFile', @success OUT, 'qa_data/tokens/outlookContacts.json'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @jsonToken, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @jsonToken
        RETURN
      END
    EXEC sp_OAMethod @jsonToken, 'StringOf', @sTmp0 OUT, 'access_token'
    EXEC sp_OASetProperty @http, 'AuthToken', @sTmp0

    -- 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

    DECLARE @json int
    -- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @json OUT

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.street', '123 Some street'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.city', 'Seattle'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.state', 'WA'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.postalCode', '98121'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, '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).

    DECLARE @id nvarchar(4000)
    SELECT @id = 'AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA='
    EXEC sp_OAMethod @http, 'SetUrlVar', @success OUT, 'id', @id

    -- Send the HTTP PATCH
    DECLARE @resp int
    EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
    EXEC sp_OAMethod @http, 'PText', @resp OUT, 'PATCH', 'https://graph.microsoft.com/v1.0/me/contacts/{$id}', @sTmp0, 'utf-8', 'application/json', 0, 0
    EXEC sp_OAGetProperty @http, 'LastMethodSuccess', @iTmp0 OUT
    IF @iTmp0 <> 1
      BEGIN
        EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @jsonToken
        EXEC @hr = sp_OADestroy @json
        RETURN
      END

    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    PRINT 'Response status code = ' + @iTmp0
    EXEC @hr = sp_OADestroy @resp

    DECLARE @jResp int
    -- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jResp OUT

    EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
    EXEC sp_OAMethod @jResp, 'Load', @success OUT, @sTmp0
    EXEC sp_OASetProperty @jResp, 'EmitCompact', 0
    EXEC sp_OAMethod @jResp, 'Emit', @sTmp0 OUT
    PRINT @sTmp0

    -- The send succeeded if the response status code = 201.
    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 200
      BEGIN

        PRINT 'Failed'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @jsonToken
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @jResp
        RETURN
      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": {}
    -- }


    PRINT 'Contact updated.'

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @jsonToken
    EXEC @hr = sp_OADestroy @json
    EXEC @hr = sp_OADestroy @jResp


END
GO