Create a contact using a specific property

You can create a contact using specific properties. In the following sample code, BEMS creates the contact in the user's contact folder. If a ParentFolderId is included, the contact is created in the specified folder.

In this example, the user creates a contact using the following information for the contact:
  • First name
  • Last name
  • Middle name
  • Mobile phone
  • Home phone
  • Business phone
  • Email address
  • Company name
POST https://localhost:8443/api/contact/create HTTP/1.1
Content-Type: application/json
X-Good-GD-AuthToken: <GDAuthToken>
 { 
   "FirstName": "NewContact",
   "LastName": "Last",
   "MiddleName": "Middle",
   "MiddleName": "Middle",
   "MobilePhone": "519-555-1234", 
   "HomePhone": "519-555-4567",
   "BusinessPhone": "519-555-7890",
   "EmailAddress1": "NewContact.Last@blackberry.com", 
   "EmailAddress2": "NewContact.Last2@blackberry.com",
   "EmailAddress3": "",
   "ParentFolderId": "AQMkADk0YzU4MjdkLWU1YjktNGE0OC1iZDczLWJjTVXVDG....",  (optional)
   "Work": {
            "JobTitle": "",
            "Department": "",
            "Company": "BlackBerry",
            "Office": "",
            "Manager": "",
            "Assistant": ""
           }
}
If the contact is created successfully, BEMS returns a uniqueId and the third-party BlackBerry Dynamics apps display the provided contact information. If a property is not specified, BEMS returns a null value and the information is not saved in the contact. 
{ 
  "UniqueId" : "Dg2Y2IxAAMkAMzAwLWJmZmYtNGJjMi1iN..."
}