Update contact
Update a contact keeping to the following parameters
Endpoint
Method | URI |
---|---|
POST |
https://apiv2.keliweb.it/api/v2/keliweb/update-contact
|
Request Parameters
Parameter | Type | Description | Required |
---|---|---|---|
HTTP headers:
Authorization
|
string |
Bearer + the token to access APIs
|
Required |
contactid
|
integer | The id of the contact to update | Required |
subaccount
|
boolean | Is the contact a subaccount | Optional |
firstname
|
string | Optional | |
lastname
|
string | Optional | |
companyname
|
string | Optional | |
email
|
string | Email address to identify the contact. This should be unique if the contact will be a sub-account | Optional |
address1
|
string | Optional | |
address2
|
string | Optional | |
city
|
string | Optional | |
state
|
string | Optional | |
postcode
|
string | Optional | |
country
|
string | 2 character ISO country code | Optional |
phonenumber
|
string | Optional | |
password2
|
string | (sub-account only) | Optional |
generalemails
|
boolean | Should the contact receive general emails | Optional |
productemails
|
boolean | Should the contact receive product emails | Optional |
domainemails
|
boolean | Should the contact receive domain emails | Optional |
invoiceemails
|
boolean | Should the contact receive invoice emails | Optional |
supportemails
|
boolean | Should the contact receive support emails | Optional |
Response Parameters
Parameter | Type | Description |
---|---|---|
result
|
string | The result of the operation: success or error |
contactid
|
integer | The contact ID that was updated |
Example Request (PHP Curl)
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://apiv2.keliweb.it/api/v2/keliweb/update-contact",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS =>
http_build_query(
array(
'contactid' => '1',
'firstname' => 'John',
'lastname' => 'Doe'
)
),
CURLOPT_HTTPHEADER => array(
"Content-Type: multipart/form-data",
"X-Requested-With: XMLHttpRequest",
"Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NhMmNlNkNjNhMmU2MmUxIzZDRkODY5MS1mMDMzLTQ1MWMtYjU-3EHc",
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
Example Request (jQuery AJAX)
var form = new FormData();
form.append("contactid", "1");
form.append("firstname", "John");
form.append("lastname", "Doe");
var settings = {
"async": true,
"crossDomain": true,
"url": "https://apiv2.keliweb.it/api/v2/keliweb/update-contact",
"method": "POST",
"headers": {
"Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImNjMDEwYWVlYmUzMjMxMmZlZjBiNzRjYTBhMmNlNDc2MjNjNhMMTA1MzJjODk1In0",
"cache-control": "no-cache",
},
"processData": false,
"contentType": false,
"mimeType": "multipart/form-data",
"data": form
}
$.ajax(settings).done(function (response) {
console.log(response);
});
Example Response (JSON payload)
{
"result" : "success",
"contactid": "1"
}