Difference between revisions of "Add Customer"

Latest revision as of 12:48, 14 November 2016

[edit] 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.

[edit] Multi Part Form Data

[edit] JSON As Body

[edit] JSON Contents

[edit] Example Input

[edit] Multi Part Form Data

   "customers":[
      {
         "name":"LeeLand",
         "external_id":"hello",
         "contact_name":"Mark Moose",
         "address_1":"1 the street",
         "postcode":"WA12 0JQ",
         "contact_number":"01942295900",
         "sic_code":238495,
         "contact_email":"stephen@mymobileworkers.com"
      }
   ]

[edit] JSON As Body

{"key":"test", "validate_only":"true", "update_existing":"true", "customers":[
      {
         "name":"LeeLand",
         "external_id":"hello",
         "contact_name":"Mark Moose",
         "address_1":"1 the street",
         "postcode":"WA12 0JQ",
         "contact_number":"01942295900"
         "sic_code":238495,
         "contact_email":"stephen@mymobileworkers.com"
      }
   ]
}

[edit] Example Curl Requests

[edit] 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://api.mymobileworkers.com:8080/api/1/companies/company/customers/customer

[edit] JSON As Body

curl -X POST -H "Content-Type: application/json" -d '{"key":"APIKEYGOESHERE", "validate_only":"true", "update_existing":"true", "customers":[{"name":"Above Average Construction Ltd.","external_id":"TestID234","contact_name":"Steve G","address_1":"123 The Street","postcode":"WA12 0JQ","contact_number":"01512143108","sic_code":238495,"contact_email":"stephen@mymobileworkers.com"}]}' http://api.mymobileworkers.com:8080/api/1/companies/company/customers/customer

[edit] Responses

[edit] Example JSON

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