curl --request POST \
--url https://app.sideshift.app/api/commerce/privacy/erase \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"orderIds": [
"order-1042"
],
"emailHash": "8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d",
"visitorIds": [
"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7"
]
}
'import requests
url = "https://app.sideshift.app/api/commerce/privacy/erase"
payload = {
"orderIds": ["order-1042"],
"emailHash": "8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d",
"visitorIds": ["8ac8d41e-8e6e-433c-bec7-19c4e027f2e7"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
orderIds: ['order-1042'],
emailHash: '8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d',
visitorIds: ['8ac8d41e-8e6e-433c-bec7-19c4e027f2e7']
})
};
fetch('https://app.sideshift.app/api/commerce/privacy/erase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.sideshift.app/api/commerce/privacy/erase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'orderIds' => [
'order-1042'
],
'emailHash' => '8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d',
'visitorIds' => [
'8ac8d41e-8e6e-433c-bec7-19c4e027f2e7'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.sideshift.app/api/commerce/privacy/erase"
payload := strings.NewReader("{\n \"orderIds\": [\n \"order-1042\"\n ],\n \"emailHash\": \"8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d\",\n \"visitorIds\": [\n \"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.sideshift.app/api/commerce/privacy/erase")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"orderIds\": [\n \"order-1042\"\n ],\n \"emailHash\": \"8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d\",\n \"visitorIds\": [\n \"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/commerce/privacy/erase")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"orderIds\": [\n \"order-1042\"\n ],\n \"emailHash\": \"8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d\",\n \"visitorIds\": [\n \"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"orders": 1,
"orderIdentities": 1,
"visitors": 2,
"conversions": 1
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Erase a shopper
Call from a trusted server when a shopper asks the custom store or the app to erase their data. Uses the store’s Orders API key and the Orders API rate limit. Erases the same data as a Shopify customers/redact request, in each store of the same site or app in the account (the same domain and platform), and in no other account. Send every identifier you hold for the shopper. A repeat returns zero counts and changes nothing. A Shopify store’s key is refused; Shopify’s own erasure request reaches SideShift through the SideShift Shopify app.
curl --request POST \
--url https://app.sideshift.app/api/commerce/privacy/erase \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"orderIds": [
"order-1042"
],
"emailHash": "8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d",
"visitorIds": [
"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7"
]
}
'import requests
url = "https://app.sideshift.app/api/commerce/privacy/erase"
payload = {
"orderIds": ["order-1042"],
"emailHash": "8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d",
"visitorIds": ["8ac8d41e-8e6e-433c-bec7-19c4e027f2e7"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
orderIds: ['order-1042'],
emailHash: '8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d',
visitorIds: ['8ac8d41e-8e6e-433c-bec7-19c4e027f2e7']
})
};
fetch('https://app.sideshift.app/api/commerce/privacy/erase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.sideshift.app/api/commerce/privacy/erase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'orderIds' => [
'order-1042'
],
'emailHash' => '8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d',
'visitorIds' => [
'8ac8d41e-8e6e-433c-bec7-19c4e027f2e7'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.sideshift.app/api/commerce/privacy/erase"
payload := strings.NewReader("{\n \"orderIds\": [\n \"order-1042\"\n ],\n \"emailHash\": \"8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d\",\n \"visitorIds\": [\n \"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.sideshift.app/api/commerce/privacy/erase")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"orderIds\": [\n \"order-1042\"\n ],\n \"emailHash\": \"8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d\",\n \"visitorIds\": [\n \"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/commerce/privacy/erase")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"orderIds\": [\n \"order-1042\"\n ],\n \"emailHash\": \"8c87b489ce35cf2e2f39f80e282cb2e804932a56a213983eeeb428407d43b52d\",\n \"visitorIds\": [\n \"8ac8d41e-8e6e-433c-bec7-19c4e027f2e7\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"orders": 1,
"orderIdentities": 1,
"visitors": 2,
"conversions": 1
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Body
Send at least one field. A browser that called identify is found through emailHash only.
SHA-256, as 64 lowercase hex characters, of the buyer's email with leading and trailing spaces removed and made lowercase. The same value window.sideshift.identify sends; no key or salt. Send hashes only; a raw email, phone, customerEmail or customerPhone field returns 400.
^[0-9a-f]{64}$Response
Erased. Counts only.