(Delphi DLL) 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 for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, HttpResponse, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
http: HCkHttp;
jsonToken: HCkJsonObject;
success: Boolean;
json: HCkJsonObject;
resp: HCkHttpResponse;
jResp: HCkJsonObject;

begin
// 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) then
  begin
    Memo1.Lines.Add(CkJsonObject__lastErrorText(jsonToken));
    Exit;
  end;
CkHttp_putAuthToken(http,CkJsonObject__stringOf(jsonToken,'access_token'));

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

json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'givenName','Pavel');
CkJsonObject_UpdateString(json,'surname','Bansky');
CkJsonObject_UpdateString(json,'emailAddresses[0].address','pavelb@fabrikam.onmicrosoft.com');
CkJsonObject_UpdateString(json,'emailAddresses[0].name','Pavel Bansky');
CkJsonObject_UpdateString(json,'businessPhones[0]','+1 732 555 0102');

// Send the HTTP POST
resp := CkHttp_PostJson2(http,'https://graph.microsoft.com/v1.0/me/contacts','application/json',CkJsonObject__emit(json));
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;
Memo1.Lines.Add('Response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
CkHttpResponse_Dispose(resp);

jResp := CkJsonObject_Create();
CkJsonObject_Load(jResp,CkHttpResponse__bodyStr(resp));
CkJsonObject_putEmitCompact(jResp,False);
Memo1.Lines.Add(CkJsonObject__emit(jResp));

// The send succeeded if the response status code = 201.
if (CkHttpResponse_getStatusCode(resp) <> 201) then
  begin
    Memo1.Lines.Add('Failed');
    Exit;
  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": {}
// }

Memo1.Lines.Add('Contact created.');

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

end;