(SQL Server) GetHarvest - Update Contact

Updates the specific contact by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Returns a contact object and a 200 OK response code if the call succeeded.

For more information, see https://help.getharvest.com/api-v2/clients-api/clients/contacts/

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
    DECLARE @sTmp0 nvarchar(4000)
    -- This example assumes the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

    DECLARE @http int
    EXEC @hr = sp_OACreate 'Chilkat_9_5_0.Http', @http OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    DECLARE @success int

    -- Implements the following CURL command:

    -- curl "https://api.harvestapp.com/v2/contacts/CONTACT_ID" \
    --   -H "Authorization: Bearer ACCESS_TOKEN" \
    --   -H "Harvest-Account-Id: ACCOUNT_ID" \
    --   -H "User-Agent: MyApp (yourname@example.com)" \
    --   -X PATCH \
    --   -H "Content-Type: application/json" \
    --   -d '{"title":"Owner"}'

    -- Use this online tool to generate code from sample JSON:
    -- Generate Code to Create JSON

    -- The following JSON is sent in the request body.

    -- {
    --   "title": "Owner"
    -- }

    DECLARE @json int
    EXEC @hr = sp_OACreate 'Chilkat_9_5_0.JsonObject', @json OUT

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'title', 'Owner'

    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'User-Agent', 'MyApp (yourname@example.com)'
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'Content-Type', 'application/json'
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'Authorization', 'Bearer ACCESS_TOKEN'
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'Harvest-Account-Id', 'ACCOUNT_ID'

    DECLARE @sbRequestBody int
    EXEC @hr = sp_OACreate 'Chilkat_9_5_0.StringBuilder', @sbRequestBody OUT

    EXEC sp_OAMethod @json, 'EmitSb', @success OUT, @sbRequestBody

    DECLARE @resp int
    EXEC sp_OAMethod @http, 'PTextSb', @resp OUT, 'PATCH', 'https://api.harvestapp.com/v2/contacts/CONTACT_ID', @sbRequestBody, 'utf-8', 'application/json', 0, 0
    EXEC sp_OAGetProperty @http, 'LastMethodSuccess', @iTmp0 OUT
    IF @iTmp0 = 0
      BEGIN
        EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @sbRequestBody
        RETURN
      END

    DECLARE @sbResponseBody int
    EXEC @hr = sp_OACreate 'Chilkat_9_5_0.StringBuilder', @sbResponseBody OUT

    EXEC sp_OAMethod @resp, 'GetBodySb', @success OUT, @sbResponseBody
    DECLARE @jResp int
    EXEC @hr = sp_OACreate 'Chilkat_9_5_0.JsonObject', @jResp OUT

    EXEC sp_OAMethod @jResp, 'LoadSb', @success OUT, @sbResponseBody
    EXEC sp_OASetProperty @jResp, 'EmitCompact', 0


    PRINT 'Response Body:'
    EXEC sp_OAMethod @jResp, 'Emit', @sTmp0 OUT
    PRINT @sTmp0

    DECLARE @respStatusCode int
    EXEC sp_OAGetProperty @resp, 'StatusCode', @respStatusCode OUT

    PRINT 'Response Status Code = ' + @respStatusCode
    IF @respStatusCode >= 400
      BEGIN

        PRINT 'Response Header:'
        EXEC sp_OAGetProperty @resp, 'Header', @sTmp0 OUT
        PRINT @sTmp0

        PRINT 'Failed.'
        EXEC @hr = sp_OADestroy @resp

        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @sbRequestBody
        EXEC @hr = sp_OADestroy @sbResponseBody
        EXEC @hr = sp_OADestroy @jResp
        RETURN
      END
    EXEC @hr = sp_OADestroy @resp

    -- Sample JSON response:

    -- {
    --   "id": 4706510,
    --   "title": "Owner",
    --   "first_name": "George",
    --   "last_name": "Frank",
    --   "email": "georgefrank@example.com",
    --   "phone_office": "",
    --   "phone_mobile": "",
    --   "fax": "",
    --   "created_at": "2017-06-26T21:44:57Z",
    --   "updated_at": "2017-06-26T21:46:48Z",
    --   "client": {
    --     "id": 5735776,
    --     "name": "123 Industries"
    --   }
    -- }

    -- Sample code for parsing the JSON response...
    -- Use the following online tool to generate parsing code from sample JSON:
    -- Generate Parsing Code from JSON

    DECLARE @id int

    DECLARE @title nvarchar(4000)

    DECLARE @first_name nvarchar(4000)

    DECLARE @last_name nvarchar(4000)

    DECLARE @email nvarchar(4000)

    DECLARE @phone_office nvarchar(4000)

    DECLARE @phone_mobile nvarchar(4000)

    DECLARE @fax nvarchar(4000)

    DECLARE @created_at nvarchar(4000)

    DECLARE @updated_at nvarchar(4000)

    DECLARE @clientId int

    DECLARE @clientName nvarchar(4000)

    EXEC sp_OAMethod @jResp, 'IntOf', @id OUT, 'id'
    EXEC sp_OAMethod @jResp, 'StringOf', @title OUT, 'title'
    EXEC sp_OAMethod @jResp, 'StringOf', @first_name OUT, 'first_name'
    EXEC sp_OAMethod @jResp, 'StringOf', @last_name OUT, 'last_name'
    EXEC sp_OAMethod @jResp, 'StringOf', @email OUT, 'email'
    EXEC sp_OAMethod @jResp, 'StringOf', @phone_office OUT, 'phone_office'
    EXEC sp_OAMethod @jResp, 'StringOf', @phone_mobile OUT, 'phone_mobile'
    EXEC sp_OAMethod @jResp, 'StringOf', @fax OUT, 'fax'
    EXEC sp_OAMethod @jResp, 'StringOf', @created_at OUT, 'created_at'
    EXEC sp_OAMethod @jResp, 'StringOf', @updated_at OUT, 'updated_at'
    EXEC sp_OAMethod @jResp, 'IntOf', @clientId OUT, 'client.id'
    EXEC sp_OAMethod @jResp, 'StringOf', @clientName OUT, 'client.name'

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @json
    EXEC @hr = sp_OADestroy @sbRequestBody
    EXEC @hr = sp_OADestroy @sbResponseBody
    EXEC @hr = sp_OADestroy @jResp


END
GO