Subscriptions
One-click unsubscribe from a win-back email
The URL in a win-back email’s List-Unsubscribe header (RFC 8058). A mail provider POSTs it with the body List-Unsubscribe=One-Click and no session or Authorization header. Turns off marketing email from the merchant for the customer the email went to, like the unsubscribe page. Unsubscribing again succeeds. Takes only the one-click token from the token query parameter; the page token is refused.
POST
/
api
/
checkout
/
v2026-04
/
win-back-offer
/
unsubscribe
/
one-click
One-click unsubscribe from a win-back email
curl --request POST \
--url https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data List-Unsubscribe=One-Clickimport requests
url = "https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click"
payload = { "List-Unsubscribe": "One-Click" }
headers = {"Content-Type": "application/x-www-form-urlencoded"}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/x-www-form-urlencoded'},
body: new URLSearchParams({'List-Unsubscribe': 'One-Click'})
};
fetch('https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click', 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://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "List-Unsubscribe=One-Click",
CURLOPT_HTTPHEADER => [
"Content-Type: application/x-www-form-urlencoded"
],
]);
$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://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click"
payload := strings.NewReader("List-Unsubscribe=One-Click")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click")
.header("Content-Type", "application/x-www-form-urlencoded")
.body("List-Unsubscribe=One-Click")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "List-Unsubscribe=One-Click"
response = http.request(request)
puts response.read_body{
"unsubscribed": true,
"meta": {
"request_id": "6f1c2a9e-3b7d-4e58-9a21-c4d8e0b7f312",
"timestamp": "2027-04-20T15:00:00Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}Query Parameters
The one-click unsubscribe token from the email's List-Unsubscribe header.
Pattern:
^swbu_Body
application/x-www-form-urlencoded
The value RFC 8058 has mail providers send.
Available options:
One-Click ⌘I
One-click unsubscribe from a win-back email
curl --request POST \
--url https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data List-Unsubscribe=One-Clickimport requests
url = "https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click"
payload = { "List-Unsubscribe": "One-Click" }
headers = {"Content-Type": "application/x-www-form-urlencoded"}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/x-www-form-urlencoded'},
body: new URLSearchParams({'List-Unsubscribe': 'One-Click'})
};
fetch('https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click', 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://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "List-Unsubscribe=One-Click",
CURLOPT_HTTPHEADER => [
"Content-Type: application/x-www-form-urlencoded"
],
]);
$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://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click"
payload := strings.NewReader("List-Unsubscribe=One-Click")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click")
.header("Content-Type", "application/x-www-form-urlencoded")
.body("List-Unsubscribe=One-Click")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/checkout/v2026-04/win-back-offer/unsubscribe/one-click")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "List-Unsubscribe=One-Click"
response = http.request(request)
puts response.read_body{
"unsubscribed": true,
"meta": {
"request_id": "6f1c2a9e-3b7d-4e58-9a21-c4d8e0b7f312",
"timestamp": "2027-04-20T15:00:00Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}