---
title: "Subscribe to the newsletter"
method: POST
path: "/api/v1/newsletter/subscribe"
tags: ["Newsletter"]
---

# Subscribe to the newsletter

`POST /api/v1/newsletter/subscribe`

## Request

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

Send a confirmation email to the address, which subscribes it once the link in it is followed (double opt-in). The answer is the same whether or not the address is already subscribed. With `newsletter: false` in `marketing.config.ts`, returns `NOT_FOUND`. With Turnstile on, needs a token in the `x-captcha-response` header

## Request body

- object
  - `email` string, email, required
  - `locale` 'en'

## Response `200`

OK

- object

## 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/newsletter/subscribe/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)