Update Customer Name

Summary

The Update Customer Name API call allows an existing customer to be updated with a new name by giving the existing name of a customer, along with the new name. A customer name can be updated via two different methods - either as multi-part form data with the 3 parameters, or as JSNO content on its own, with the API key supplied within the JSON.

Multi Part Form Data

Update Customer Name
URL	http://base_url/api_path/version/companies/company/customers/updatename
Type	POST
Params:	api_key	required
	existing_name	required
	new_name	required
	Response	JSON

JSON As Body

Create Job - JSON
URL	http://base_url/api_path/version/companies/company/customers/updatename
Type	POST
	JSON {key, existing_customer_name, new_customer_name}	required
Response	JSON

JSON Contents

The Update Customer Name JSON

Standard Fields
Field	Expected Data	Required
key	varchar(255)	✓
existing_customer_name	varchar(255)	✓
new_customer_name	varchar(255)	✓

Example Input

JSON As Body

{
   "key":"your_api_key",
   "existing_customer_name":"oldName123",
   "new_customer_name":"newName456"
}

Example Curl Request

Multi Part Form Data

curl -F api_key=YOUR_KEY -F existing_name=CUSTOMER_EXISTING_NAME -F new_name=CUSTOMER_NEW_NAME http://live.mymobileworkers.com:8080/api/1/companies/company/customers/updatename

JSON As Body

curl -X POST -H "Content-Type: application/json" -d '{"key":"YOUR_KEY", "existing_customer_name":"OLDNAME", "new_customer_name":"NEWNAME"}' http://live.mymobileworkers.com:8080/api/1/companies/company/customers/updatename

Responses

Successful

{"result":"success","existing_customer_name":"testName24","new_customer_name":"darrenTest24"}

Unsuccessful

{"error_code":"CUS002","error_message":"Customer cannot be found"}
{"error_code":"CUS011","error_message":"Customer name not provided. Please specify customer name in the request."}
{"result":"failed","existing_customer_name":"testName24","new_customer_name":"darrenTest24"}