docs: @RequestMapping(value = "/api/profile/{profileIdentifier}/clients", method = RequestMethod.POST)
      public
      @ResponseBody
      HashMap<String, Object> addClient(Model model,
                                        @PathVariable("profileIdentifier") String profileIdentifier,
                                        @RequestParam(required = false) String friendlyName) throws Exception {
          Integer profileId = ControllerUtils.convertProfileIdentifier(profileIdentifier);
  
          // make sure client with this name does not already exist
          if (null != clientService.findClientFromFriendlyName(profileId, friendlyName)) {
          	throw new Exception("Cannot add client. Friendly name already in use.");
          }
          
          Client client = clientService.add(profileId);
  
          // set friendly name if it was specified
          if (friendlyName != null) {
              clientService.setFriendlyName(profileId, client.getUUID(), friendlyName);
              client.setFriendlyName(friendlyName);
          }
  
          HashMap<String, Object> valueHash = new HashMap<String, Object>();
          valueHash.put("client", client);
          return valueHash;
      }