Difference between revisions of "Create Customer Sites"

Latest revision as of 14:04, 31 January 2017

In the portal, a Customer Contact is now referred to as a Customer Site.

[edit] Summary

The create customer contacts action allows users to attach a contacts to a customer. This method accepts an array of contacts to be added to the system. A contact 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

{
   "customer_contacts":[
      {
	"external_id":"Contact1",
	"contact_name":"test_contact",
	"customer_id":{
		"name":"test"
	},
	"address_1":"8 The Parks",
	"address_2":"address 3",
	"address_3":"address 4",
	"address_4":"address 5",
	"postcode":"WA12 0JQ",
	"contact_number":"01234567891",
        "sic_code":074313,
        "contact_email":"stephen@mymobileworkers.com"
      }
   ]
}

[edit] JSON As Body

{
   "key":"testkey",
   "validate_only":"false",
   "update_existing":"true",
   "customer_contacts":[
      {
         "external_id":"Contact1",
         "contact_name":"test_contact",
         "customer_id":{
            "name":"test"
         },
         "address_1":"8 The Parks",
         "address_2":"address 3",
         "address_3":"address 4",
         "address_4":"address 5",
         "postcode":"WA12 0JQ",
         "contact_number":"01234567891",
         "sic_code":074313,
         "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=testkey -F file=@/Users/testuser/Desktop/webAPICurling/create_customer_contacts.txt http://api.mymobileworkers.com:8080/api/1/companies/company/customers/contacts

[edit] JSON As Body

curl -X POST -H "Content-Type: application/json" -d '{"key":"x4IOX6J3RcESDsN0kBAd","validate_only":"false","update_existing":"true","customer_contacts":[{"external_id":"ExtIdTest","contact_name":"Steve G","customer_id":{"name":"Above Average Construction Ltd."},"address_1":"Unit 5","address_2":"Random Industrial Estate","address_3":"Little Lane","address_4":"Somewhere","postcode":"WA12JQ","contact_number":"01512143108","sic_code":2323525,"contact_email":"stephen@mymobileworkers.com"}]}' http://api.mymobileworkers.com:8080/api/1/companies/company/customers/contacts

[edit] Responses

[edit] Example JSON

{
   "successful":[
      {
         "contact_name":"test_contact"
      }
   ],
   "failed":[
      {
         "contact_name":"test_contact",
         "errors":[
            {
               "error_code":"CCV002",
               "error_message":"Address 1 cannot be null."
            }
         ]
      }
   ]
}