Leads
Allows to add, get, change Salesforce Leads info to visitor profile.
Each method has a visitor ID (UUID v4) as part of the URI.
The current visitor ID is associated with his "short-access-token".
Get
This method allows to get Salesforce info from existing visitor profile by its visitorId.
Method
GET
URI
/leads/v1/:visitorId
Headers
Content-Type application/json
Authorization Bearer <short-access-token>
Result
{
/* salesforce.leads table fields */
}
var myHeaders = new Headers();
myHeaders.append('Authorization', 'Bearer <short-access-token>');
myHeaders.append('Content-Type', 'application/json');
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch('https://api.sunbreak.io/leads/v1/245ce633-796f-4dfa-ae6f-4b2762adbf45', requestOptions)
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error(error));
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://api.sunbreak.io/leads/v1/245ce633-796f-4dfa-ae6f-4b2762adbf45',
'headers': {
'Authorization': 'Bearer <short-access-token>',
'Content-Type': 'application/json'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.sunbreak.io/leads/v1/245ce633-796f-4dfa-ae6f-4b2762adbf45');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'Authorization' => 'Bearer <short-access-token>',
'Content-Type' => 'application/json'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
Put
This method allows to update the profile for the current visitor.
Method
PUT
URI
/leads/v1/:visitorId
Headers
Content-Type application/json
Authorization Bearer <short-access-token>
Body
{
"email": "my@mail.com",
"segment": "segment-db-name" /* optional */
}
Result
{
/* default profile fields */
"created_at": "YYYY-MM-DDThh:mm:ss",
"geoip": {},
"last_ip": "x.x.x.x",
"user_metadata": {},
"visited_query_strings": [],
"visited_pages": [],
/* new fields */
"email": "my@mail.com",
"salesforce": {}
}
var myHeaders = new Headers();
myHeaders.append('Authorization', 'Bearer <short-access-token>');
myHeaders.append('Content-Type', 'application/json');
var requestOptions = {
method: 'PUT',
headers: myHeaders,
redirect: 'follow',
body: JSON.stringify({
email: 'my@mail.com'
})
};
fetch('https://api.sunbreak.io/leads/v1/245ce633-796f-4dfa-ae6f-4b2762adbf45', requestOptions)
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error(error));
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.sunbreak.io/leads/v1/245ce633-796f-4dfa-ae6f-4b2762adbf45',
'headers': {
'Authorization': 'Bearer <short-access-token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'my@mail.com'
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.sunbreak.io/leads/v1/245ce633-796f-4dfa-ae6f-4b2762adbf45');
$request->setMethod(HTTP_Request2::METHOD_PUT);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setBody('{"email": "my@mail.com"}');
$request->setHeader(array(
'Authorization' => 'Bearer <short-access-token>',
'Content-Type' => 'application/json'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}