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