Update a contact's list information

You can update information for a contact using specific properties. In the following sample code, BEMS updates the contact information for NewContact Last in the user's contact folder. The client sends the UniqueID for the contact to update. When a contact is updated, the client sends all of the values for the contact to BEMS, whether the values were modified or not. If the client provides a ParentFolderID, BEMS updates the contact in the specified folder.

In this example, the contact is updated with their work information. The new and existing information is sent to BEMS for updating.
  • Job title
  • Department
  • Middle name
  • Mobile phone
  • Home phone
  • Business phone
  • Email address
  • Company name
POST https://localhost:8443/api/contact/update HTTP/1.1
Content-Type: application/json
X-Good-GD-AuthToken: <GDAuthToken>
  {
    "UniqueId": "AAMkADY2ZjRkY2E2LWY0ZDQtNGU3Ni1hMjk3LTAwM....",
    "FirstName": "NewContact",
    "LastName": "Last",
    "MiddleName": "Middle",
    "MobilePhone": "519-555-1234", 
    "HomePhone": "519-555-4567",
    "BusinessPhone": "519-555-7890", 
    "EmailAddress1": "NewContact.Last@blackberry.com", 
    "EmailAddress2": "NewContact.Last2@blackberry.com",
    "Work": {
             "JobTitle": "Manager",
             "Department": "Development",
             "Company": "BlackBerry",
             "Office": "Home"
            },
    "FolderId": "AQMkADk0YzU4MjdkLWU1YjktNGE0OC1iZDczKI0Kuc7BmRwA..."" (optional)    
  }

If the request is successful, BEMS returns a 200 HTTP response code that the contact is successfully updated.