Difference between revisions of "Add Customer"

Revision as of 12:18, 28 August 2013

Summary

The add customer action allows users to attach a customer to their company. This method accepts an array of customers to be added to the system. A customer can be created via two different methods - either as multi-part form data with a JSON file attached and the API key as a parameter, or as JSON content on it's own, with the API key supplied within the JSON.

Multi Part Form Data

JSON As Body (13.6)

JSON Contents

Example Input

Multi Part Form Data

   "customers":[
      {
         "name":"LeeLand",
         "contact_name":"Mark Moose",
         "address_1":"1 the street",
         "postcode":"WA12 0JQ",
         "contact_number":"01942295900"
      }
   ]

JSON As Body (13.6)

{"key":"test", "validate_only":"true", "update_existing":"true", "customers":[
      {
         "name":"LeeLand",
         "contact_name":"Mark Moose",
         "address_1":"1 the street",
         "postcode":"WA12 0JQ",
         "contact_number":"01942295900"
      }
   ]
}

Example Curl Requests

Multi Part Form Data

curl -F validate_only=false -F update_existing=true -F api_key=YOURKEY -F file=@/Users/lee_orritt/Desktop/webAPICurling/create_customer.txt http://test.mymobileworkers.com:8080/api/1/companies/company/customers/customer

JSON As Body (13.6)

curl -X POST -H "Content-Type: application/json" -d '{"key":"darrenwebapi", "validate_only":"false", "update_existing":true,"customers":[{"name":"LeeLand","contact_name":"testName","address_1":"1 the street","postcode":"WA12 0JQ","contact_number":"01942295900"}]}' http://live.mymobileworkers.com:8080/api/1/companies/company/customers/customer

Responses

Example JSON

{
   "file":"tick.png",
   "comment":"Transferred from API",
   "created_at":"2013-05-20T14:42:37+00:00"
}