Guest data extensions enable your organization to store any additional information around customer interactions, beyond the predefined Sitecore CDP guest attributes
While creating Guest the response provide the gust ref. Using this reference we can add data extension to the guest. See screen below to get the various ways to get gust referece-
You can also get the ref from portal for the respective guest (set the debug mode)-
Go to Portal and Guest page. Search the gust with name-
Click on the settings button (only available in debug mode). Note the reference of guest.
Create Data Extension for Guest-
https://{{apiEndpoint}}/{{restApiVersion}}/25aef18c-8a29-46f0-9dd5-0ab3994025ee/extExt
Ext – is the extension key
Request-
Ensure request is sent using Basic Auth where User Name is the Client Key and Password is Api Token. Take the credentials from portal (API Access menu option).
Response-
Check the extension data in portal, under properties tab-
You can create multiple gust extension for given guest, although it is recommended to have one-
cURL code snippet-
curl --location --request POST 'https://api.boxever.com/v2/guests/25aef18c-8a29-46f0-9dd5-0ab3994025ee/extExt' \
--header 'Authorization: Basic <<Enter Toekn>>' \
--header 'Content-Type: application/json' \
--data-raw '{
"key": "default",
"isPremiumClient": true
}'C# code snippet-
var client = new RestClient("https://api.boxever.com/v2/guests/25aef18c-8a29-46f0-9dd5-0ab3994025ee/extExt");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Basic <<Enter Token>>");
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@" ""key"": ""default"",
" + "\n" +
@" ""isPremiumClient"": true
" + "\n" +
@"}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);Python code snippet-
import http.client
import json
conn = http.client.HTTPSConnection("api.boxever.com")
payload = json.dumps({
"key": "default",
"isPremiumClient": True
})
headers = {
'Authorization': 'Basic <<Entert Token>>',
'Content-Type': 'application/json'
}
conn.request("POST", "/v2/guests/25aef18c-8a29-46f0-9dd5-0ab3994025ee/extExt", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))Javascript code snippet-
var settings = {
"url": "https://api.boxever.com/v2/guests/25aef18c-8a29-46f0-9dd5-0ab3994025ee/extExt",
"method": "POST",
"timeout": 0,
"headers": {
"Authorization": "Basic <<Enter Token>>",
"Content-Type": "application/json"
},
"data": JSON.stringify({
"key": "default",
"isPremiumClient": true
}),
};
$.ajax(settings).done(function (response) {
console.log(response);
});Similarly you can update and delete guest extension data. See the links here
Update guest data extension-
Delete guest data extension-
Reference-
