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