Create a contact using a specific property Skip Navigation

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..." }