(SQL Server) Outlook Contacts Create a Contact

See more Outlook Contact Examples

Creates an Outlook Contact.

For more information, see https://docs.microsoft.com/en-us/graph/api/user-post-contacts?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 POST:

    -- POST https://graph.microsoft.com/v1.0/me/contacts
    -- Content-type: application/json
    -- 
    -- {
    --   "givenName": "Pavel",
    --   "surname": "Bansky",
    --   "emailAddresses": [
    --     {
    --       "address": "pavelb@fabrikam.onmicrosoft.com",
    --       "name": "Pavel Bansky"
    --     }
    --   ],
    --   "businessPhones": [
    --     "+1 732 555 0102"
    --   ]
    -- }

    -- 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, 'givenName', 'Pavel'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'surname', 'Bansky'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'emailAddresses[0].address', 'pavelb@fabrikam.onmicrosoft.com'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'emailAddresses[0].name', 'Pavel Bansky'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'businessPhones[0]', '+1 732 555 0102'

    -- Send the HTTP POST
    DECLARE @resp int
    EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
    EXEC sp_OAMethod @http, 'PostJson2', @resp OUT, 'https://graph.microsoft.com/v1.0/me/contacts', 'application/json', @sTmp0
    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 <> 201
      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/\"EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYfT\"",
    --   "id": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=",
    --   "createdDateTime": "2021-06-29T16:32:05Z",
    --   "lastModifiedDateTime": "2021-06-29T16:32:06Z",
    --   "changeKey": "EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYfT",
    --   "categories": [
    --   ],
    --   "parentFolderId": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQAuAAAAAAAu7cUXL5YOTrdsUIw7-v8FAQBUcG0qWqkmQYqWLHQataQxAAAAAAEOAAA=",
    --   "birthday": null,
    --   "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": {},
    --   "businessAddress": {},
    --   "otherAddress": {}
    -- }


    PRINT 'Contact created.'

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


END
GO