Saved Searches

One-Click Unsubscribe From A Saved Search Alert (Rfc 8058)

Changed on Oct 10, 2026

Turn off the email alert of the saved search the signed token names. Answers both the one-click unsubscribe mail clients send (RFC 8058) and the button on the confirmation page.

post/v0/saved_searches/alerts/unsubscribe

Request

Base URL
https://api.theirstack.com
URL
https://api.theirstack.com/v0/saved_searches/alerts/unsubscribe
Auth
none declared

Query parameters

tokenstring required

Request body application/x-www-form-urlencoded

list_unsubscribestring

Response

Successful Response

Changes

Oct 10, 20263c1b2daafcc9 Revision changes
- breaking
  removed the media type application/json for the response with the status
- info
  added the media type text/html for the response with the status
Jul 13, 2026641fc0ca14d0 Revision changes
- info
  endpoint added

Operation history