---
title: "Single opt-in newsletter subscribe (form-encoded)"
method: POST
path: "/api/newsletter/subscribe"
---

# Single opt-in newsletter subscribe (form-encoded)

`POST /api/newsletter/subscribe`

## Request

- Base URL: `https://theagentsindex.com`
- URL: `https://theagentsindex.com/api/newsletter/subscribe`
- Auth: none declared

Single opt-in email capture for the directory digest. Content-Type MUST be application/x-www-form-urlencoded (or multipart/form-data); because it is a form POST, Astro's cross-origin protection requires a same-origin Origin header. Field: email (required); optional source, interest. Responds with a self-contained text/html confirmation page (200). The intake is rate-limited per IP per hour.

## Response `200`

A text/html confirmation page.

## Other responses

- `400`: Invalid email — a text/html page explaining the fix.
- `404`: Newsletter disabled for this tenant.

---

[API](https://skmtc.dev/theagentsindex/apis/the-agents-index-machine-api.md) · [All operations](https://skmtc.dev/theagentsindex/apis/the-agents-index-machine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentsindex/apis/the-agents-index-machine-api/revisions/575bafbb80ad?raw)