---
title: "Unsubscribe from a category of emails"
method: POST
path: "/api/v1/notifications/unsubscribe"
tags: ["Notifications"]
---

# Unsubscribe from a category of emails

`POST /api/v1/notifications/unsubscribe`

## Request

- Base URL: `https://app.easyscraper.com`
- URL: `https://app.easyscraper.com/api/v1/notifications/unsubscribe`
- Auth: none required

Turns off the emails of an unsubscribe link's category for its user (their email preference for it), keeping whether they see it in the app. When this turned them off, `undoToken` turns them back on with `resubscribe` for the next hour; it's left out when they were off already. Unsubscribing again changes nothing. Returns `NOT_FOUND` for tokens this app didn't make

## Request body

- object
  - `token` string, required

## Response `200`

OK

- object
  - `category` 'security' | 'membership' | 'team' | 'billing' | 'feedback', required
  - `email` unknown, required
  - `undoToken` string

## Other responses

- `400`: 400
- `404`: 404
- `429`: 429

## Changes

- **2026-11-02** `a12cef98c52b`: 1 info
  - added the non-success response with the status `400`
- **2026-10-31** `3e642e95991a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/easyscraper/apis/easy-scraper-api/changes/api/v1/notifications/unsubscribe/post.md)

---

[API](https://skmtc.dev/easyscraper/apis/easy-scraper-api.md) - [All operations](https://skmtc.dev/easyscraper/apis/easy-scraper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyscraper/apis/easy-scraper-api/revisions/a12cef98c52b?raw)